Adobe Suite

Adobe Suite Folders API

Folders are a capability that let you better organize your business objects for easier navigability and categorization.

GitHub OpenAPI

Operations 6

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

POST /unifiedfolders/folders/{FOLDER_TYPE} Create a folder · Create a folder #
Ask an LLM
“How do I create a folder to organize my datasets or segments?”
“Can I create a folder inside an existing parent folder?”
Tell an agent
Create a {FOLDER_TYPE} folder named {name}.
Create {FOLDER_TYPE} folder {name} under parent {parentId}.
GET /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID} Get a folder's details · Retrieve a specified folder #
Ask an LLM
“What are the details of a specific folder?”
“Can I look up one folder by its type and ID?”
Tell an agent
Show me {FOLDER_TYPE} folder {FOLDER_ID}.
Retrieve folder {FOLDER_ID} of type {FOLDER_TYPE}.
PATCH /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID} Update a folder · Update a specific folder #
Ask an LLM
“How can I rename or move an existing folder?”
“Is it possible to change a folder's details after creating it?”
Tell an agent
Update {FOLDER_TYPE} folder {FOLDER_ID}.
Rename folder {FOLDER_ID} of type {FOLDER_TYPE}.
DELETE /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID} Delete a folder · Delete a specific folder #
Ask an LLM
“How do I delete a folder I no longer need?”
“Can I remove a specific folder by ID?”
Tell an agent destructive · confirm first
Delete {FOLDER_TYPE} folder {FOLDER_ID}.
Remove folder {FOLDER_ID} of type {FOLDER_TYPE}.
GET /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID}/subfolders List a folder's subfolders · Retrieve a folder's subfolders #
Ask an LLM
“Which subfolders sit inside a given folder?”
“Can I browse the child folders under a parent folder?”
Tell an agent
List subfolders of {FOLDER_TYPE} folder {FOLDER_ID}.
Show the child folders under folder {FOLDER_ID} of type {FOLDER_TYPE}.
GET /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID}/validate Check if a folder can hold objects · Validate a specific folder #
Ask an LLM
“Is this folder eligible to have objects placed in it?”
“Can I verify a folder accepts content before moving things there?”
Tell an agent
Validate {FOLDER_TYPE} folder {FOLDER_ID} for holding objects.
Check whether folder {FOLDER_ID} of type {FOLDER_TYPE} can contain objects.

Documentation

📖
Documentation
https://developer.adobe.com/photoshop/api/docs/
📖
Authentication
https://developer.adobe.com/developer-console/docs/guides/authentication/
📖
Documentation
https://developer.adobe.com/lightroom/api/docs/
📖
Documentation
https://developer.adobe.com/illustrator/api/docs/
📖
Documentation
https://developer.adobe.com/indesign/docs/
📖
Documentation
https://developer.adobe.com/document-services/docs/overview/pdf-services-api/
📖
Documentation
https://developer.adobe.com/document-services/docs/overview/pdf-extract-api/
📖
GettingStarted
https://developer.adobe.com/document-services/docs/overview/pdf-extract-api/gettingstarted/
📖
Documentation
https://developer.adobe.com/document-services/docs/overview/pdf-accessibility-auto-tag-api/
📖
Documentation
https://developer.adobe.com/analytics-apis/docs/
📖
APIReference
https://developer.adobe.com/analytics-apis/docs/2.0/
📖
Documentation
https://developer.adobe.com/firefly-services/docs/
📖
APIReference
https://developer.adobe.com/firefly-services/docs/api/
📖
Documentation
https://developer.adobe.com/audio-video-firefly-services/
📖
GettingStarted
https://developer.adobe.com/audio-video-firefly-services/getting-started/
📖
Documentation
https://developer.adobe.com/creative-cloud-libraries/docs/
📖
APIReference
https://developer.adobe.com/creative-cloud-libraries/docs/api/
📖
Documentation
https://developer.adobe.com/express/embed-sdk/docs/guides/
📖
APIReference
https://developer.adobe.com/express/embed-sdk/docs/v4/
📖
GettingStarted
https://developer.adobe.com/express/embed-sdk/docs/guides/quickstart/
📖
Documentation
https://developer.adobe.com/experience-platform-apis/
📖
GettingStarted
https://experienceleague.adobe.com/en/docs/experience-platform/landing/platform-apis/api-guide
📖
Documentation
https://developer.adobe.com/marketo-apis/
📖
Authentication
https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/authentication
📖
Documentation
https://developer.adobe.com/commerce/docs/
📖
GettingStarted
https://developer.adobe.com/commerce/webapi/get-started/
📖
Documentation
https://developer.adobe.com/experience-cloud/cloud-manager/
📖
Documentation
https://developer.adobe.com/journey-optimizer-apis/
📖
Documentation
https://developer.adobe.com/workfront-apis/
📖
Documentation
https://developer.adobe.com/firefly-services/docs/substance3d/
📖
Documentation
https://developer.adobe.com/data-collection-apis/
📖
Documentation
https://developer.adobe.com/adobe-status/
📖
Documentation
https://developer.adobe.com/vip-marketplace/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/openapi/adobe-suite-folders-api-openapi.yml

Other Resources

🔗
Pricing
https://developer.adobe.com/document-services/pricing/
🔗
SDKs
https://developer.adobe.com/document-services/docs/overview/pdf-services-api/sdks/
🔗
ReleaseNotes
https://developer.adobe.com/document-services/docs/overview/pdf-services-api/releasenotes
🔗
Guides
https://developer.adobe.com/analytics-apis/docs/2.0/guides/
🔗
Guides
https://developer.adobe.com/firefly-services/docs/guides/
🔗
Usage Notes
https://developer.adobe.com/audio-video-firefly-services/getting_started/usage/
🔗
Overview
https://developer.adobe.com/creative-cloud-libraries/docs/overview/
🔗
Integration Guide
https://developer.adobe.com/creative-cloud-libraries/docs/integrate/
🔗
API Fundamentals
https://experienceleague.adobe.com/en/docs/experience-platform/landing/platform-apis/api-fundamentals
🔗
Developer Guide
https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home
🔗
REST API
https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/rest/rest-api
🔗
REST API
https://developer.adobe.com/commerce/webapi/rest/
🔗
GraphQL API
https://developer.adobe.com/commerce/webapi/graphql-api/
🔗
REST API Reference
https://developer.adobe.com/commerce/webapi/reference/rest/paas/
🔗
GraphQL
https://raw.githubusercontent.com/api-evangelist/adobe-suite/refs/heads/main/graphql/adobe-suite-graphql.md
🔗
Webhooks
https://developer.adobe.com/experience-cloud/cloud-manager/guides/getting-started/create-event-integration/
🔗
StatusPage
https://status.adobe.com/

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-folders-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

adobe-suite-folders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Unified Tags Folders 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: Folders
  description: Folders are a capability that let you better organize your business objects for easier navigability and categorization.
paths:
  /unifiedfolders/folders/{FOLDER_TYPE}:
    post:
      tags:
      - Folders
      summary: Create a folder
      operationId: createFolder
      parameters:
      - $ref: '#/components/parameters/folder-type'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      - $ref: '#/components/parameters/x-sandbox-name'
      requestBody:
        description: The request body to create the folder.
        content:
          '*/*':
            schema:
              $ref: '#/components/schemas/createFolderBody'
        required: true
      responses:
        200:
          x-summary: Created
          description: A new folder was successfully created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/folder'
  /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID}:
    get:
      tags:
      - Folders
      summary: Retrieve a specified folder
      operationId: retrieveFolder
      parameters:
      - $ref: '#/components/parameters/folder-type'
      - $ref: '#/components/parameters/folder-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      - $ref: '#/components/parameters/x-sandbox-name'
      responses:
        200:
          x-summary: Success
          description: Returns the specified folder
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/folder'
    patch:
      tags:
      - Folders
      summary: Update a specific folder
      operationId: updateFolder
      parameters:
      - $ref: '#/components/parameters/folder-type'
      - $ref: '#/components/parameters/folder-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      - $ref: '#/components/parameters/x-sandbox-name'
      requestBody:
        description: The request body to update the folder.
        content:
          '*/*':
            schema:
              type: array
              items:
                $ref: '#/components/schemas/updateFolderBody'
        required: true
      responses:
        200:
          x-summary: Success
          description: The folder was successfully updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/updatedFolder'
    delete:
      tags:
      - Folders
      summary: Delete a specific folder
      operationId: deleteFolder
      parameters:
      - $ref: '#/components/parameters/folder-type'
      - $ref: '#/components/parameters/folder-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      - $ref: '#/components/parameters/x-sandbox-name'
      responses:
        200:
          x-summary: Success
          description: The folder was successfully deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/deleteFolderResponse'
  /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID}/subfolders:
    get:
      tags:
      - Folders
      summary: Retrieve a folder's subfolders
      operationId: getSubfolders
      parameters:
      - $ref: '#/components/parameters/folder-type'
      - $ref: '#/components/parameters/folder-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      - $ref: '#/components/parameters/x-sandbox-name'
      responses:
        200:
          x-summary: Success
          description: The list of subfolders was successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/foldersList'
  /unifiedfolders/folders/{FOLDER_TYPE}/{FOLDER_ID}/validate:
    get:
      tags:
      - Folders
      summary: Validate a specific folder
      description: Use this endpoint to validate if a folder is eligible to have objects in it.
      operationId: validateFolder
      parameters:
      - $ref: '#/components/parameters/folder-type'
      - $ref: '#/components/parameters/folder-id'
      - $ref: '#/components/parameters/authorization'
      - $ref: '#/components/parameters/content-type'
      - $ref: '#/components/parameters/x-gw-ims-org-id'
      - $ref: '#/components/parameters/x-api-key'
      - $ref: '#/components/parameters/x-sandbox-name'
      responses:
        200:
          x-summary: Success
          description: The folder was successfully validated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/folder'
components:
  schemas:
    createFolderBody:
      type: object
      properties:
        name:
          type: string
          description: The name of the folder you want to create.
          example: SampleFolder
        parentId:
          type: string
          description: The parent ID of the folder you want to create.
          example: 6a5e0927-1527-4abc-9993-376fd7067ca5
    updatedFolder:
      type: object
      allOf:
      - $ref: '#/components/schemas/folder'
      - type: object
        properties:
          name:
            type: string
            description: The updated name for the folder.
            example: RenamedSampleFolder
    deleteFolderResponse:
      type: object
      description: A successful deletion response body.
      properties:
        message:
          type: string
          example: delete request accepted successfully
    childFolder:
      type: object
      allOf:
      - $ref: '#/components/schemas/folder'
      - type: object
        properties:
          name:
            type: string
            example: ChildFolder
            description: The name for the child folder.
          parentId:
            type: string
            example: c626b4f7-223b-4486-8900-00c266e31dd1
            description: The ID of the parent folder.
          children:
            type: array
            description: An array showing children folders that belong to the child folder.
            example: []
            items: {}
          _links:
            type: object
            example: null
            description: A link to the child folder.
    updateFolderBody:
      type: object
      description: The request body to update the folder.
      required:
      - op
      - path
      - value
      properties:
        op:
          type: string
          description: The type of operation for the PATCH operation. Only `replace` is supported.
          example: replace
          enum:
          - replace
        path:
          type: string
          example: /name
          description: The path for the field that needs to be updated.
        value:
          type: string
          description: The updated value for the field that needs to be updated.
          example: RenamedSampleFolder
    foldersList:
      type: object
      description: A list of subfolders for the requested folder.
      properties:
        id:
          type: string
          example: c626b4f7-223b-4486-8900-00c266e31dd1
          description: The ID of the folder.
        name:
          type: string
          example: ParentFolder
          description: The name of the folder.
        noun:
          type: string
          example: dataset
          description: The type of the business object that the folder contains.
        imsOrg:
          type: string
          example: '{IMS_ORG}'
          description: The ID of the organization that the folder belongs to.
        sandboxId:
          type: string
          example: '{SANDBOX_ID}'
          description: The ID of the sandbox that the folder belongs to.
        sandboxName:
          type: string
          example: prod
          description: The name of the sandbox that the folder belongs to.
        createdBy:
          type: string
          example: 'null'
          description: The ID of the user who created the folder.
        createdAt:
          type: string
          example: '2023-01-12T03:31:00.118+00:00'
          description: The date and time that the folder was created.
        modifiedBy:
          type: string
          example: 'null'
          description: The ID of the user who last modified the folder.
        modifiedAt:
          type: string
          example: '2023-01-13T05:47:06.718+00:00'
          description: The date and time that the folder was last modified.
        _links:
          type: object
          example: null
          description: A link to the folder.
        children:
          type: array
          description: The child folders for the parent folders.
          items:
            $ref: '#/components/schemas/childFolder'
    folder:
      type: object
      properties:
        id:
          type: string
          example: 83f8287c-767b-4106-b271-257282fd170e
          description: The ID of the folder.
        name:
          type: string
          example: SampleFolder
          description: The name of the folder.
        noun:
          type: string
          example: dataset
          description: The type of business objects that belong to the folder. Possible values include `dataset` and `segment`.
        imsOrg:
          type: string
          example: '{ORG_ID}'
          description: The ID of the organization that the folder belongs to.
        sandboxId:
          type: string
          example: '{SANDBOX_ID}'
          description: The ID of the sandbox that the folder belongs to.
        sandboxName:
          type: string
          example: prod
          description: The name of the sandbox that the folder belongs to.
        createdBy:
          type: string
          example: '{USER_ID}'
          description: The ID of the user who created the folder.
        createdAt:
          type: string
          example: '2023-10-01T08:47:06.192+00:00'
          description: The date and time that the folder was created.
        modifiedBy:
          type: string
          example: '{USER_ID}'
          description: The ID of the user who last modified the folder.
        modifiedAt:
          type: string
          example: '2023-10-01T08:47:06.192+00:00'
          description: The date and time that the folder was last modified.
        status:
          type: string
          example: IN_USE
          description: The status of the folder. Possible values include `IN_USE` and `ARCHIVED`.
        _links:
          type: object
          properties:
            self:
              type: object
              properties:
                href:
                  type: string
                  example: /folders/dataset/83f8287c-767b-4106-b271-257282fd170e
          description: A link to the folder.
  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
    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
    folder-id:
      name: FOLDER_ID
      in: path
      description: The ID of the folder.
      required: true
      schema:
        type: string
    folder-type:
      name: FOLDER_TYPE
      in: path
      description: The type of folder you're retrieving. Supported values include `segment` and `dataset`.
      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
    x-sandbox-name:
      name: x-sandbox-name
      in: header
      description: All resources in Experience Platform are isolated to specific virtual sandboxes. Requests to Platform APIs require a header that specifies the name of the sandbox in which the operation will take place. See the [sandboxes overview](https://adobe.com/go/sandbox-overview-en) for more information.
      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