# Add Pipeline Tag

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Add Pipeline Tag"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v1/workspaces/{workspace_name}/pipelines/{pipeline_name}/tags"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Add a tag to a pipeline.

Tag names must be 1-50 characters and may contain letters, digits, spaces, underscores,
and hyphens. Duplicate tags are rejected case-insensitively. Each pipeline supports at
most three tags. Returns the pipeline's full tag list after the add.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"description":"Name of the pipeline.","in":"path","name":"pipeline_name","required":true,"schema":{"description":"Name of the pipeline.","title":"Pipeline Name","type":"string"}},{"description":"Type the name of the workspace.","in":"path","name":"workspace_name","required":true,"schema":{"description":"Type the name of the workspace.","title":"Workspace Name","type":"string"}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"properties":{"name":{"description":"Name of the tag.","title":"Tag Name","type":"string"}},"required":["name"],"title":"PipelineTagAdd","type":"object"}}},"required":true}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"title":"Response Add Pipeline Tag Api V1 Workspaces  Workspace Name  Pipelines  Pipeline Name  Tags Post","type":"array"}}},"description":"Successful Response"},"404":{"description":"We couldn't find the pipeline you specified. Make sure the name is correct and the pipeline exists in the workspace you specified."},"409":{"description":"Tag limit reached or tag already exists on the pipeline."},"422":{"description":"Invalid tag name."}}}
>
  
</StatusCodes>