Adobe Suite

Adobe Suite Tag categories API

Tag categories let you organize your tags into meaningful sets, allowing you to provide more context to the tag's purpose.

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /unifiedtags/tagCategory List unified tag categories · List tag categories #

Ask an LLM

“What tag categories exist for organizing tags in Experience Platform?”

“Can I sort tag categories by name or page through them?”

Tell an agent

List all tag categories.

List tag categories sorted by {sortBy} in {sortOrder} order.

POST /unifiedtags/tagCategory Create a tag category · Create a new tag category #

Ask an LLM

“How do I create a new category to group unified tags?”

“Can I give a tag category a description when I make it?”

Tell an agent

Create a tag category named {name}.

Create tag category {name} described as {description}.

GET /unifiedtags/tagCategory/{TAG_CATEGORY_ID} Retrieve a tag category · Retrieve a specific tag category #

Ask an LLM

“What are the details of one tag category?”

“Can I look up a tag category by its ID?”

Tell an agent

Get tag category {TAG_CATEGORY_ID}.

Show the details of tag category {TAG_CATEGORY_ID}.

PATCH /unifiedtags/tagCategory/{TAG_CATEGORY_ID} Update a tag category · Update a specific tag category #

Ask an LLM

“How do I rename an existing tag category?”

“Does updating a tag category require admin rights?”

Tell an agent

Update tag category {TAG_CATEGORY_ID} with my changes.

Rename tag category {TAG_CATEGORY_ID} as I describe.

DELETE /unifiedtags/tagCategory/{TAG_CATEGORY_ID} Delete a tag category · Delete a specific tag category #

Ask an LLM

“Who is allowed to delete a tag category?”

“Can I remove a tag category we no longer need?”

Tell an agent destructive · confirm first

Delete tag category {TAG_CATEGORY_ID}.

Remove the tag category {TAG_CATEGORY_ID}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/adobe-suite:adobe-suite-tag-categories-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Unified Tags Tag categories API
  version: '1.0'
  description: Use the Unified Tags API to create folders, tags, and tag categories, which let you better organize your business objects.
servers:
- url: https://experience.adobe.io
tags:
- name: Tag categories
  description: Tag categories let you organize your tags into meaningful sets, allowing you to provide more context to the tag's purpose.
paths:
  /unifiedtags/tagCategory:
    get:
      tags:
      - Tag categories
      summary: List tag categories
      operationId: listTagCategories
      parameters:
      - $ref: '#/components/parameters/start'
      - $ref: '#/components/parameters/limitTagCategories'
      - $ref: '#/components/parameters/propertyTagCategories'
      - $ref: '#/components/parameters/sortByTagCategories'
      - $ref: '#/components/parameters/sortOrderTagCategories'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      responses:
        200:
          x-summary: Success
          description: A list of tag categories that belongs to the organization is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tagCategoriesList'
    post:
      tags:
      - Tag categories
      summary: Create a new tag category
      operationId: createTagCategory
      parameters:
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      requestBody:
        description: The request body to create the tag category.
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/createTagCategoryBody'
        required: true
      responses:
        200:
          x-summary: Success
          description: The tag category was successfully created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tagCategory'
  /unifiedtags/tagCategory/{TAG_CATEGORY_ID}:
    get:
      tags:
      - Tag categories
      summary: Retrieve a specific tag category
      operationId: retrieveTagCategory
      parameters:
      - $ref: '#/components/parameters/tag-category-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      responses:
        200:
          x-summary: Success
          description: The specified tag category was successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tagCategory'
    patch:
      tags:
      - Tag categories
      summary: Update a specific tag category
      description: '**Important:** Only the system administrator and the product administrator can use this API call.'
      operationId: updateTagCategory
      parameters:
      - $ref: '#/components/parameters/tag-category-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      requestBody:
        description: The request body to update the tag category.
        content:
          '*/*':
            schema:
              type: array
              items:
                $ref: '#/components/schemas/updateTagCategoryBody'
      responses:
        200:
          x-summary: Success
          description: The tag category was successfully updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/updatedTagCategory'
    delete:
      tags:
      - Tag categories
      summary: Delete a specific tag category
      description: '**Important:** Only the system administrator and the product administrator can use this API call.'
      operationId: deleteTagCategory
      parameters:
      - $ref: '#/components/parameters/tag-category-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      responses:
        200:
          x-summary: Success
          description: The tag category was successfully deleted.
          content: {}
components:
  parameters:
    x-api-key:
      name: x-api-key
      in: header
      description: The API key which can be copied from your Experience Platform integration. For more information on how to obtain this value, visit the [authentication tutorial](http://www.adobe.com/go/platform-api-authentication-en).
      required: true
      schema:
        type: string
    sortOrderTagCategories:
      name: sortOrder
      in: query
      description: The direction in which the tag categories are sorted by. Supported values include `asc` and `desc`.
      schema:
        type: string
    propertyTagCategories:
      name: property
      in: query
      description: The attribute you want to filter by when retrieving tag categories.
      schema:
        type: string
    authorization:
      name: Authorization
      in: header
      description: The access token which can be copied from your Experience Platform integration, prefixed with "Bearer ". For more information on how to obtain this value, visit the [authentication tutorial](http://www.adobe.com/go/platform-api-authentication-en).
      required: true
      schema:
        type: string
    content-type:
      name: Content-Type
      in: header
      description: The type of content being sent in the body of the request. This value should be `application/json`.
      required: true
      schema:
        type: string
    tag-category-id:
      name: TAG_CATEGORY_ID
      in: path
      description: The ID of the tag category.
      required: true
      schema:
        type: string
    x-gw-ims-org-id:
      name: x-gw-ims-org-id
      in: header
      description: The Organization ID which can be copied from your Experience Platform integration. For more information on how to obtain this value, visit the [authentication tutorial](http://www.adobe.com/go/platform-api-authentication-en).
      required: true
      schema:
        type: string
    limitTagCategories:
      name: limit
      in: query
      description: The maximum number of tag categories you want retrieved per page.
      schema:
        type: string
    start:
      name: start
      in: query
      description: The location where the list of results starts from. You can use this to indicate the starting index for pagination of results.
      schema:
        type: string
    sortByTagCategories:
      name: sortBy
      in: query
      description: The order in which the tag categories are sorted by. Supported values include `name`, `createdAt`, and `modifiedAt`.
      schema:
        type: string
  schemas:
    tagCategoriesList:
      type: object
      properties:
        _page:
          type: object
          properties:
            count:
              description: The number of tag categories that match the given query parameters listed.
              type: integer
              example: 1
            limit:
              description: The number of tag categories returned per page.
              type: integer
              example: 10
            property:
              description: The property used to filter the tag categories.
              type: array
              example: []
              items: {}
        tags:
          type: array
          description: The list of tag categories that match the property filter.
          items:
            $ref: '#/components/schemas/tagCategory'
    updateTagCategoryBody:
      type: object
      properties:
        op:
          description: The operation for the PATCH call. Only `replace` is supported.
          type: string
          example: replace
        path:
          description: The path of the field you want to update. Supported values include `/name` and `/description`.
          type: string
          example: description
        value:
          type: string
          description: The updated value of the field you want to update.
          example: Updated sample description
        from:
          type: string
          description: The original value of the field you want to update.
          example: Sample test category description
    createTagCategoryBody:
      type: object
      properties:
        name:
          description: The name for the tag category you want to create.
          type: string
          example: Sample Test Category
        description:
          description: The description of the tag category you want to create.
          type: string
          example: Sample test category description
    updatedTagCategory:
      type: object
      allOf:
      - $ref: '#/components/schemas/tagCategory'
      - type: object
        properties:
          description:
            type: string
            description: The updated value of the description.
            example: Updated sample description
    tagCategory:
      type: object
      properties:
        id:
          type: string
          description: The ID of the tag category.
          example: e2b7c656-067b-4413-a366-adde0401df50
        name:
          type: string
          description: The name of the tag category.
          example: Sample Tag Category
        description:
          type: string
          description: A description for the tag category.
          example: Sample tag category description
        org:
          type: string
          description: The ID of the organization that the tag category belongs to.
          example: '{ORG_ID}'
        createdBy:
          description: The ID of the user who created the tag category.
          type: string
          example: '{USER_ID}'
        createdAt:
          description: The timestamp that the tag category was created at.
          type: string
          example: '1661752268000'
        modifiedBy:
          description: The ID of the user who last modified the tag category.
          type: string
          example: '{USER_ID}'
        modifiedAt:
          description: The timestamp that the tag category was created at.
          type: string
          example: '1661752268000'
        tagCount:
          description: The number of tags that belong to the tag category.
          type: integer
          example: 0

Adobe Suite Tag categories API

Operations 5

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification