Klaviyo Tags API

openapi: 3.0.2
info:
  title: Klaviyo Accounts Tags API
  version: '2026-04-15'
  description: The Klaviyo REST API. Please visit https://developers.klaviyo.com for more details.
  contact:
    name: Klaviyo Developer Experience Team
    email: developers@klaviyo.com
    url: https://developers.klaviyo.com
  termsOfService: https://www.klaviyo.com/legal/api-terms
  license:
    name: License
    url: https://www.klaviyo.com/legal
servers:
- url: https://a.klaviyo.com
  description: Production
security:
- Klaviyo-API-Key: []
tags:
- name: Tags
  description: tags
paths:
  /api/tags:
    get:
      operationId: get_tags
      summary: Get Tags
      description: 'List all tags in an account.


        Tags can be filtered by `name`, and sorted by `name` or `id` in ascending or descending order.


        Returns a maximum of 50 tags per request, which can be paginated with

        [cursor-based pagination](https://developers.klaviyo.com/en/v2022-10-17/reference/api_overview#pagination).<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`'
      parameters:
      - name: fields[tag-group]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - default
            - exclusive
            - name
        explode: false
      - name: fields[tag]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - name
        explode: false
      - name: filter
        in: query
        description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`name`: `contains`, `ends-with`, `equals`, `starts-with`'
        schema:
          type: string
          example: equals(name,'My Tag')
      - name: include
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
        schema:
          type: array
          items:
            type: string
            enum:
            - tag-group
        explode: false
      - name: page[cursor]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        required: false
        schema:
          type: string
      - name: page[size]
        in: query
        description: 'Default: 50. Min: 1. Max: 50.'
        required: false
        schema:
          type: integer
          default: 50
          maximum: 50
          minimum: 1
      - name: sort
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
        schema:
          type: string
          enum:
          - id
          - -id
          - name
          - -name
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagResponseCollectionCompoundDocument'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
    post:
      operationId: create_tag
      summary: Create Tag
      description: 'Create a tag. An account cannot have more than **500** unique tags.


        A tag belongs to a single tag group. If `relationships.tag-group.data.id` is not specified,

        the tag is added to the account''s default tag group.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`

        `tags:write`'
      parameters:
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagCreateQuery'
      responses:
        '201':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/PostTagResponse'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      - tags:write
  /api/tags/{id}:
    get:
      operationId: get_tag
      summary: Get Tag
      description: 'Retrieve the tag with the given tag ID.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: fields[tag-group]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - default
            - exclusive
            - name
        explode: false
      - name: fields[tag]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - name
        explode: false
      - name: include
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships
        schema:
          type: array
          items:
            type: string
            enum:
            - tag-group
        explode: false
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagResponseCompoundDocument'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
    patch:
      operationId: update_tag
      summary: Update Tag
      description: 'Update the tag with the given tag ID.


        Only a tag''s `name` can be changed. A tag cannot be moved from one tag group to another.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagUpdateQuery'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      - tags:write
    delete:
      operationId: delete_tag
      summary: Delete Tag
      description: 'Delete the tag with the given tag ID. Any associations between the tag and other resources will also be removed.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      - tags:write
  /api/tag-groups:
    get:
      operationId: get_tag_groups
      summary: Get Tag Groups
      description: 'List all tag groups in an account. Every account has one default tag group.


        Tag groups can be filtered by `name`, `exclusive`, and `default`, and sorted by `name` or `id` in ascending or descending order.


        Returns a maximum of 25 tag groups per request, which can be paginated with

        [cursor-based pagination](https://developers.klaviyo.com/en/v2022-10-17/reference/api_overview#pagination).<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`'
      parameters:
      - name: fields[tag-group]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - default
            - exclusive
            - name
        explode: false
      - name: filter
        in: query
        description: 'For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`name`: `contains`, `ends-with`, `equals`, `starts-with`<br>`exclusive`: `equals`<br>`default`: `equals`'
        schema:
          type: string
          example: equals(name,'My Tag Group')
      - name: page[cursor]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination
        required: false
        schema:
          type: string
      - name: page[size]
        in: query
        description: 'Default: 25. Min: 1. Max: 25.'
        required: false
        schema:
          type: integer
          default: 25
          maximum: 25
          minimum: 1
      - name: sort
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting
        schema:
          type: string
          enum:
          - id
          - -id
          - name
          - -name
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagGroupResponseCollection'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      x-klaviyo-subtag: Tag Groups
    post:
      operationId: create_tag_group
      summary: Create Tag Group
      description: 'Create a tag group. An account cannot have more than **50** unique tag groups.


        If `exclusive` is not specified `true` or `false`, the tag group defaults to non-exclusive.


        If a tag group is non-exclusive, any given related resource (campaign, flow, etc.)

        can be linked to multiple tags from that tag group.

        If a tag group is exclusive, any given related resource can only be linked to one tag from that tag group.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`

        `tags:write`'
      parameters:
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagGroupCreateQuery'
      responses:
        '201':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/PostTagGroupResponse'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      - tags:write
      x-klaviyo-subtag: Tag Groups
  /api/tag-groups/{id}:
    get:
      operationId: get_tag_group
      summary: Get Tag Group
      description: 'Retrieve the tag group with the given tag group ID.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`'
      parameters:
      - name: id
        in: path
        description: The Tag Group ID
        required: true
        schema:
          description: The Tag Group ID
          type: string
          example: zyxw9876-vu54-ts32-rq10-zyxwvu654321
      - name: fields[tag-group]
        in: query
        description: For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets
        required: false
        schema:
          type: array
          items:
            type: string
            enum:
            - default
            - exclusive
            - name
        explode: false
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagGroupResponse'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      x-klaviyo-subtag: Tag Groups
    patch:
      operationId: update_tag_group
      summary: Update Tag Group
      description: 'Update the tag group with the given tag group ID.


        Only a tag group''s `name` can be changed. A tag group''s `exclusive` or `default` value cannot be changed.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag Group ID
        required: true
        schema:
          description: The Tag Group ID
          type: string
          example: zyxw9876-vu54-ts32-rq10-zyxwvu654321
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagGroupUpdateQuery'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      - tags:write
      x-klaviyo-subtag: Tag Groups
    delete:
      operationId: delete_tag_group
      summary: Delete Tag Group
      description: 'Delete the tag group with the given tag group ID.


        Any tags inside that tag group, and any associations between those tags and other resources, will also be removed. The default tag group cannot be deleted.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `tags:read`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag Group ID
        required: true
        schema:
          description: The Tag Group ID
          type: string
          example: zyxw9876-vu54-ts32-rq10-zyxwvu654321
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - tags:read
      - tags:write
      x-klaviyo-subtag: Tag Groups
  /api/tags/{id}/relationships/flows:
    get:
      operationId: get_flow_ids_for_tag
      summary: Get Flow IDs for Tag
      description: 'Returns the IDs of all flows associated with the given tag.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `flows:read`

        `tags:read`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagFlowRelationshipsResponseCollection'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - get_tag_relationships_flows
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - flows:read
      - tags:read
    post:
      operationId: tag_flows
      summary: Tag Flows
      description: 'Associate a tag with one or more flows. Any flow cannot be associated with more than **100** tags.



        Use the request body to pass in the ID(s) of the flow(s) that will be associated with the tag.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `flows:write`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagFlowOp'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - create_tag_relationships_flow
      - add_flows_to_tag
      - create_tag_relationships_flows
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - flows:write
      - tags:write
    delete:
      operationId: remove_tag_from_flows
      summary: Remove Tag from Flows
      description: 'Remove a tag''s association with one or more flows.



        Use the request body to pass in the ID(s) of the flows(s) whose association with the tag

        will be removed.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `flows:write`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagFlowOp'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - delete_tag_relationships_flows
      - remove_flows_from_tag
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - flows:write
      - tags:write
  /api/tags/{id}/relationships/campaigns:
    get:
      operationId: get_campaign_ids_for_tag
      summary: Get Campaign IDs for Tag
      description: 'Returns the IDs of all campaigns associated with the given tag.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `campaigns:read`

        `tags:read`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagCampaignRelationshipsResponseCollection'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - get_tag_relationships_campaigns
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - campaigns:read
      - tags:read
    post:
      operationId: tag_campaigns
      summary: Tag Campaigns
      description: 'Associate a tag with one or more campaigns. Any campaign cannot be associated with more than **100** tags.



        Use the request body to pass in the ID(s) of the campaign(s) that will be associated with the tag.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `campaigns:write`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagCampaignOp'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - create_tag_relationships_campaign
      - add_campaigns_to_tag
      - create_tag_relationships_campaigns
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - campaigns:write
      - tags:write
    delete:
      operationId: remove_tag_from_campaigns
      summary: Remove Tag from Campaigns
      description: 'Remove a tag''s association with one or more campaigns.



        Use the request body to pass in the ID(s) of the campaign(s) whose association with the tag

        will be removed.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `campaigns:write`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagCampaignOp'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - delete_tag_relationships_campaigns
      - remove_campaigns_from_tag
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - campaigns:write
      - tags:write
  /api/tags/{id}/relationships/lists:
    get:
      operationId: get_list_ids_for_tag
      summary: Get List IDs for Tag
      description: 'Returns the IDs of all lists associated with the given tag.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `lists:read`

        `tags:read`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      responses:
        '200':
          description: Success
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/GetTagListRelationshipsResponseCollection'
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - get_tag_relationships_lists
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - lists:read
      - tags:read
    post:
      operationId: tag_lists
      summary: Tag Lists
      description: 'Associate a tag with one or more lists. Any list cannot be associated with more than **100** tags.



        Use the request body to pass in the ID(s) of the lists(s) that will be associated with the tag.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `lists:write`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagListOp'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - create_tag_relationships_list
      - add_lists_to_tag
      - create_tag_relationships_lists
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - lists:write
      - tags:write
    delete:
      operationId: remove_tag_from_lists
      summary: Remove Tag from Lists
      description: 'Remove a tag''s association with one or more lists.



        Use the request body to pass in the ID(s) of the list(s) whose association with the tag

        will be removed.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`


        **Scopes:**

        `lists:write`

        `tags:write`'
      parameters:
      - name: id
        in: path
        description: The Tag ID
        required: true
        schema:
          description: The Tag ID
          type: string
          example: abcd1234-ef56-gh78-ij90-abcdef123456
      - name: revision
        in: header
        description: 'API endpoint revision (format: YYYY-MM-DD[.suffix])'
        required: true
        schema:
          type: string
          default: '2026-04-15'
      requestBody:
        required: true
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/TagListOp'
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/ClientError'
        5XX:
          $ref: '#/components/responses/ServerError'
      tags:
      - Tags
      x-klaviyo-operation-aliases:
      - delete_tag_relationships_lists
      - remove_lists_from_tag
      x-klaviyo-pre-release: None
      x-klaviyo-ratelimit:
        burst: 3/s
        steady: 60/m
      x-klaviyo-scopes:
      - lists:write
      - tags:write
  /api/tags/{id}/relationships/segments:
    get:
      operationId: get_seg

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-tags-api-openapi.yml