Using Postman

Postman is a convenient way to explore the Brand Intelligence API without writing code. This guide walks through setting up an environment, generating a token, and running a validation invocation.

Prerequisites

• Postman installed.
• OAuth Server-to-Server credentials from Adobe Developer Console (see Authentication).

Step 1 - Set up a Postman environment

Create a new environment in Postman with the following variables:

data-variant=warning

data-slots=text

Step 2 - Generate an access token

Create a new POST request:

• URL: {{ims_url}}/ims/token/v3
• Body (x-www-form-urlencoded):

To automatically save the token to your environment, add this script to the Post-response tab:

const token = pm.response.json().access_token;
pm.environment.set("access_token", token);

Send the request. Postman will store the token in the access_token variable, ready for use in subsequent requests.

Tokens are valid for 24 hours. Re-run this request when your token expires.

Step 3 - Import the OpenAPI spec (optional)

You can import the Brand Intelligence OpenAPI spec directly into Postman to auto-generate a request collection:

1. Open the API Reference page and use its Download OpenAPI specification link to save the spec file.
2. In Postman, select Import and choose the downloaded file.
3. Postman will generate a collection with all available endpoints pre-populated.
4. Set the collection's Authorization to Bearer Token and set the token value to {{access_token}}.

Step 4 - Submit a validation invocation

Create a POST request:

• URL: {{base_url}}/api/abi/skills/ra
• Authorization: Bearer Token → {{access_token}}
• Body (raw JSON):

{
  "tenantId": "{{tenant_id}}",
  "displayName": "My first validation invocation",
  "items": [
    {
      "itemSource": "blob",
      "sourceRef": "<publicly accessible asset URL>",
      "mediaType": "image/png",
      "itemName": "asset-01"
    }
  ]
}

The response includes an invocationId. Copy it into your invocation_id environment variable.

Step 5 - Poll and retrieve results

Poll invocation status:

• GET {{base_url}}/api/abi/skills/ra/{{invocation_id}}
• Authorization: Bearer Token → {{access_token}}

Repeat until status is completed, failed, or cancelled.

Fetch results:

• GET {{base_url}}/api/abi/skills/ra/{{invocation_id}}/items
• Authorization: Bearer Token → {{access_token}}

See the Quickstart for annotated example responses.