Adobe Suite

Adobe Suite Segment definitions API

Segment definitions include a Profile Query Language (PQL) statement that defines which profiles will be part of an audience. More information about using this set of endpoints can be found in the [segment definitions endpoint guide](https://experienceleague.adobe.com/docs/experience-platform/segmentation/api/segment-definitions.html).

GitHub OpenAPI
Business capability
Customer Segmentation Management BC-420.20

Operations 7

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 /segment/definitions List segment definitions · List segment definitions #
Ask an LLM
“What audience segment definitions exist in my Experience Platform sandbox?”
“Can I page and sort through all my segment definitions?”
Tell an agent
List my segment definitions.
List {limit} segment definitions per page sorted by {sort}.
POST /segment/definitions Create a segment definition · Create a segment definition #
Ask an LLM
“How do I define a new audience with a PQL expression?”
“Which fields are required when creating a segment definition?”
Tell an agent
Create a segment definition named {name} with expression {expression} on schema {schema}.
Define a new audience {name} described as {description} using {expression} against {schema}.
GET /segment/definitions/{SEGMENT_ID} Get one segment definition · Retrieve a segment definition #
Ask an LLM
“How do I see the expression and settings of a specific segment definition?”
“Can I look up a segment definition by its ID?”
Tell an agent
Show segment definition {SEGMENT_ID}.
Get the rule behind audience {SEGMENT_ID}.
DELETE /segment/definitions/{SEGMENT_ID} Delete a segment definition · Delete a segment definition #
Ask an LLM
“How do I remove an audience segment definition I no longer need?”
“Can I delete a segment definition by ID?”
Tell an agent destructive · confirm first
Delete segment definition {SEGMENT_ID}.
Remove audience definition {SEGMENT_ID} from the sandbox.
PATCH /segment/definitions/{SEGMENT_ID} Overwrite an existing segment definition · Overwrite a segment definition #
Ask an LLM
“Can I change the expression of a segment definition that already exists?”
“What happens to the fields I leave out when I update a segment definition?”
Tell an agent
Update segment definition {SEGMENT_ID} to use expression {expression}.
Overwrite segment {SEGMENT_ID} with name {name}, expression {expression} and schema {schema}.
POST /segment/definitions/bulk-get Fetch several segment definitions by ID · Retrieve multiple segment definitions using multiple segment definition IDs #
Ask an LLM
“Can I retrieve multiple segment definitions in one request?”
“Is there a bulk lookup for segment definitions when I have a list of IDs?”
Tell an agent
Fetch the segment definitions {ids}.
Bulk get these audience definitions: {ids}.
POST /segment/conversion Convert a segment expression between PQL formats · Convert a segment definition #
Ask an LLM
“How do I turn a PQL text expression into its JSON form?”
“Can I convert a segment definition from pql/json back to pql/text?”
Tell an agent
Convert the expression {expression} for segment {name} on schema {schema} to the other PQL format.
Translate segment {name}'s PQL expression {expression} between text and JSON using schema {schema}.

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://artifacts.apis.io/adobe-suite/openapi/adobe-suite-segment-definitions-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://artifacts.apis.io/adobe-suite/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-segment-definitions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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-segment-definitions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Segmentation Service Segment definitions API
  description: Adobe Experience Platform Segmentation Service provides a user interface and RESTful API that allows you to create audiences through segment definitions or other sources from your Real-Time Customer Profile data.
  version: '1.0'
servers:
- url: //{environment}.adobe.io/data/core/ups
  variables:
    environment:
      default: platform
      enum:
      - platform
      - platform-stage
tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/adobe-suite/openapi/adobe-suite-segment-definitions-api-openapi.yml