Upload and manage assets (source files) for PDF operations.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/adobe-assets-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Adobe Assets API
version: '1.0'
description: 'Operations tagged Assets across 2 of this provider''s published API definitions: adobe-pdf-services-api-openapi-official.json, adobe-pdf-services-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://pdf-services-ue1.adobe.io
- url: https://pdf-services-ew1.adobe.io
- url: https://pdf-services.adobe.io
description: Adobe PDF Services API - Default Production
tags:
- name: Assets
description: 'Upload and download assets to Adobe internal storage.
Uploading and downloading of assets is not required when using a custom external storage solution with signed URLs.
Note: Assets uploaded to Adobe internal storage are transiently stored for 24 hours.'
paths:
/assets:
post:
tags:
- Assets
summary: Get upload pre-signed URI
description: 'Get the pre-signed URI to directly upload the content to the adobe''s internal cloud provider.
Output: Response will have the asset URI of created asset and pre-signed URI for uploading the content.
Note: The pre-signed URI provided for uploading or downloading the content has an expiry of 1 hour.'
operationId: asset.uploadpresignedurl
parameters:
- name: Authorization
in: header
description: Bearer + Token (<a href="https://developer.adobe.com/document-services/docs/overview/pdf-services-api/gettingstarted/#step-1--getting-the-access-token">Learn more</a> about getting the access token)
required: true
schema:
type: string
- name: x-api-key
in: header
description: The clientId from the generated credentials
required: true
schema:
type: string
requestBody:
description: Params for getting upload presigned url Operation
content:
application/json:
schema:
$ref: '#/components/schemas/GetUploadPresignedUrlRequest'
required: true
responses:
'200':
description: The request was successful.
headers:
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetUploadPresignedUrlAsset'
'400':
description: Bad Request. The request was invalid or cannot be otherwise served.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/400'
'401':
description: Unauthorized.
headers:
content-type:
description: The content type of the error JSON response.
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'429':
description: Caller doesn't have sufficient quota for this operation.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Asset429'
'500':
description: Internal Server Error. The server has encountered an error and is unable to process your request at this time.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/500'
servers:
- url: https://pdf-services-ue1.adobe.io
- url: https://pdf-services-ew1.adobe.io
/assets/{assetId}:
get:
tags:
- Assets
summary: Get download pre-signed URI
description: 'Get the pre-signed URI to fetch the content directly from the cloud provider.
Note: The pre-signed URI provided for uploading or downloading the content has an expiry of 1 hour.'
operationId: asset.get
parameters:
- name: Authorization
in: header
description: Bearer + Token (<a href="https://developer.adobe.com/document-services/docs/overview/pdf-services-api/gettingstarted/#step-1--getting-the-access-token">Learn more</a> about getting the access token)
required: true
schema:
type: string
- name: x-api-key
in: header
description: The clientId from the generated credentials
required: true
schema:
type: string
responses:
'200':
description: The request was successful.
headers:
Content-Type:
description: The media type of the response body, which is application/json.
schema:
type: string
x-request-id:
description: A unique ID to identify each individual request.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPresignedUrl'
'400':
description: Bad Request. The request was invalid or cannot be otherwise served.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/400'
'401':
description: Unauthorized.
headers:
content-type:
description: The content type of the error JSON response.
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'429':
description: Caller doesn't have sufficient quota for this operation.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Asset429'
'500':
description: Internal Server Error. The server has encountered an error and is unable to process your request at this time.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/500'
delete:
tags:
- Assets
summary: Delete the asset from storage
description: Delete the stored asset from the cloud provider.
operationId: asset.delete
parameters:
- name: Authorization
in: header
description: Bearer + Token (<a href="https://developer.adobe.com/document-services/docs/overview/pdf-services-api/gettingstarted/#step-1--getting-the-access-token">Learn more</a> about getting the access token)
required: true
schema:
type: string
- name: x-api-key
in: header
description: The clientId from the generated credentials
required: true
schema:
type: string
responses:
'204':
description: The request was successful, but no content received.
headers:
Content-Type:
description: The media type of the response body, which is application/json.
schema:
type: string
x-request-id:
description: A unique ID to identify each individual request.
schema:
type: string
'400':
description: Bad Request. The request was invalid or cannot be otherwise served.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/400'
'401':
description: Unauthorized.
headers:
content-type:
description: The content type of the error JSON response.
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'429':
description: Caller doesn't have sufficient quota for this operation.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Asset429'
'500':
description: Internal Server Error. The server has encountered an error and is unable to process your request at this time.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/500'
servers:
- url: https://pdf-services-ue1.adobe.io
- url: https://pdf-services-ew1.adobe.io
/assets/{assetId}/metadata:
get:
tags:
- Assets
summary: Get asset metadata
description: Get the metadata of the stored temporary asset.
operationId: asset.metadata
parameters:
- name: Authorization
in: header
description: Bearer + Token (<a href="https://developer.adobe.com/document-services/docs/overview/pdf-services-api/gettingstarted/#step-1--getting-the-access-token">Learn more</a> about getting the access token)
required: true
schema:
type: string
- name: x-api-key
in: header
description: The clientId from the generated credentials
required: true
schema:
type: string
responses:
'200':
description: The request was successful.
headers:
Content-Type:
description: The media type of the response body, which is application/json.
schema:
type: string
x-request-id:
description: A unique ID to identify each individual request.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/AssetMetadata'
'400':
description: Bad Request. The request was invalid or cannot be otherwise served.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/400'
'401':
description: Unauthorized.
headers:
content-type:
description: The content type of the error JSON response.
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/401'
'429':
description: Caller doesn't have sufficient quota for this operation.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Asset429'
'500':
description: Internal Server Error. The server has encountered an error and is unable to process your request at this time.
headers:
content-type:
description: The content type of the POST API call response
schema:
type: string
x-request-id:
description: A unique value to identify this request. If x-request-id is specified in the POST request, this value will be the same as the input.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/500'
servers:
- url: https://pdf-services-ue1.adobe.io
- url: https://pdf-services-ew1.adobe.io
/assets/{assetID}:
get:
operationId: getAsset
summary: Adobe Get Asset Download Uri
description: Retrieve a pre-signed download URI for a previously created asset or job output. The download URI is valid for a limited time.
tags:
- Assets
parameters:
- $ref: '#/components/parameters/assetID'
responses:
'200':
description: Asset download URI returned successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/AssetDownloadResponse'
examples:
Getasset200Example:
summary: Default getAsset 200 response
x-microcks-default: true
value:
assetID: '500123'
downloadUri: https://www.example.com
'404':
$ref: '#/components/responses/NotFound'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
security:
- bearerAuth: []
delete:
operationId: deleteAsset
summary: Adobe Delete an Asset
description: Delete a previously uploaded asset from the platform.
tags:
- Assets
parameters:
- $ref: '#/components/parameters/assetID'
responses:
'204':
description: Asset deleted successfully.
'404':
$ref: '#/components/responses/NotFound'
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
security:
- bearerAuth: []
servers:
- url: https://pdf-services-ue1.adobe.io
description: Adobe PDF Services API - US East Production
- url: https://pdf-services.adobe.io
description: Adobe PDF Services API - Default Production
components:
schemas:
GetUploadPresignedUrlAsset:
type: object
properties:
assetID:
description: An asset ID identifying an asset that is globally unique and never reused.
type: string
uploadUri:
description: The URL used to upload the Resource directly to the cloud provider.
type: string
example:
assetID: urn:aaid:AS:UE1:23c30ee0-2c4d-46d6-87f2-087832fca718
uploadUri: https://dcplatformstorageservice-dev-us-east-1.s3-accelerate.amazonaws.com/aa8d8790-321a-4487-92da-0e90ba931239?X-Amz-Security-Token=FwoGZXIvYXdzEP7%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDDvZayrA6JI2vhkxPiLTAVI%2Fy0F2v7Us5rBDlEd53dHuO2KAe5Bkbs2AmUHtscOPbsH%2Bzh1aFDnv%2BW2nHAiENSNbV2Auq6b5%2FatImE8hUs2wTwV%2BCSB%2FJb896AF905k%2B9ljhZDty2caFGQSHY2lC2OQ4Rr9%2FdS%2FNKwWgnHr4Ld5AtweavSyfhFMfz%2Fw7zLXvHupnLhOISBqqEOTMQim4YDLGzxIt9%2F4C1MKBUSSdGYBX14rfjTSiB%2FivjjjEdNrRRnkGoIg%2Fxe5b1dFDdgukwXWEBsKtZ2qpmZl2uW1boMTHonQoxMTCmAYyLS2FEiNOvaV7rvm8oy6MtGvv2JVY%2FPz%2FFPab%2BhjsCG60vS3kHih4Zy8rUUKv%2Fw%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220901T121500Z&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Expires=3599&X-Amz-Credential=REDACTED_AWS_ACCESS_KEY_ID%2F20220901%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=5424c781b8671fb1d7e068267af26e9de4d9a606f343c0bb8602d2a70ab52fcd
AssetMetadata:
type: object
properties:
entity:
description: Technical Account ID or User ID with access to blob.
type: string
size:
description: The size of the Resource in bytes. This value helps in making range requests.
type: integer
type:
description: 'The content type of the file. For e.g: application/pdf.'
type: string
example:
entity: 49505D56624424F00A49423A@techacct.adobe.com
size: 13552
type: application/pdf
'401':
properties:
error:
type: object
properties:
code:
description: The string containing the code field. code is the Mnemonic returned by service in case of any failure. The below list is extendable and going forward the error codes can become more specific.
type: string
message:
description: "An English language string that contains more information about the error. \n\n<table><tr><th>code</th><th>message</th></tr><tr><td>UNAUTHORIZED</td><td>Not authorised to perform the operation.</td></tr></table>"
type: string
example:
error:
code: UNAUTHORIZED
message: Not authorised to perform the operation.
'400':
properties:
error:
type: object
properties:
code:
description: The string containing the code field. code is the Mnemonic returned by service in case of any failure. The below list is extendable and going forward the error codes can become more specific.
type: string
message:
description: "An English language string that contains more information about the error. \n\n<table><tr><th>code</th><th>message</th></tr><tr><td>BAD_REQUEST</td><td>Bad Request.</td></tr></table>"
type: string
example:
error:
code: BAD_REQUEST
message: Bad Request.
'500':
properties:
error:
type: object
properties:
code:
description: The string containing the code field. code is the Mnemonic returned by service in case of any failure. The below list is extendable and going forward the error codes can become more specific.
type: string
message:
description: "An English language string that contains more information about the error. \n\n<table><tr><th>code</th><th>message</th></tr><tr><td>INTERNAL_SERVER_ERROR</td><td>There was an error processing your request.</td></tr><tr><td>UNKNOWN</td><td>Unknown error.</td></tr></table>"
type: string
example:
error:
code: INTERNAL_SERVER_ERROR
message: There was an error processing your request.
GetPresignedUrl:
type: object
properties:
downloadUri:
description: The URL used to download the Resource directly from the storage provider.
type: string
size:
description: The size of the Resource in bytes. This value helps in making range requests.
type: integer
type:
description: The media type of the Resource.
type: string
example:
downloadUri: https://dcplatformstorageservice-dev-us-east-1.s3-accelerate.amazonaws.com/a059e98b-43bf-4e76-886b-e61a1a19c7bd?X-Amz-Security-Token=FwoGZXIvYXdzEOz%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDJoRurLDIx1KmzjT9yLTAZwtCBavc2xtc6InMLLl2rS480ulHYpVTyWSAtCDj34blxS9sghuPqX%2FwTsvUOJZCvgL8kMqHm0khmO3Pnh1%2FOYU1MksBbAlZ47JExBGdzwIsnh8gMIEXBaty0nVmQjIVLUogOKTIyoBuJsnGDvjytpABIpIzbYH50aTS4yECx42ejL6Po%2F4LOroTO3bv98MuUh05hdiFeoCrTfu29%2FXL5%2FuHXo0R1TfgiNPeR6Riq4PL3v%2BSNzPflWlToGIPtWYMWKuEtIEtK0J2Ut3Bddpxevd%2BxsozM2%2BmAYyLblFR%2BVAADnVcQZDc0fW7A8g9iM9BpKQIgmBY9rJrKjj53%2BFHvDko8%2FbkUlGcA%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20220831T182204Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=REDACTED_AWS_ACCESS_KEY_ID%2F20220831%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=298a811048105d8093539c6fab4e8649f96af0fcbad17ee5a716e6175e6e166b
size: 13130
type: application/pdf
GetUploadPresignedUrlRequest:
type: object
properties:
mediaType:
description: 'The content type of the file to be stored. For e.g: application/pdf.'
type: string
example:
mediaType: application/pdf
Asset429:
properties:
error_code:
description: 'The string containing the code field. code is the Mnemonic returned by service in case of any failure. The below list is extendable and going forward the error codes can become more specific. '
type: string
message:
description: "An English language string that contains more information about the error. \n\n<table><tr><th>code</th><th>message</th></tr><tr><td>429001</td><td>Service usage limit reached</td></tr><tr><td>429002</td><td>Developer key usage limit reached</td></tr><tr><td>429050</td><td>Too many requests</td></tr></table>"
type: string
example:
error_code: '429050'
message: Too many requests
AssetDownloadResponse:
type: object
properties:
assetID:
type: string
description: The unique identifier of the asset.
example: '500123'
downloadUri:
type: string
format: uri
description: The pre-signed URI to download the asset. Valid for a limited time.
example: https://www.example.com
ErrorResponse:
type: object
description: Error response returned when a request fails.
properties:
error:
type: object
properties:
code:
type: string
description: A machine-readable error code.
examples:
- INVALID_ASSET_ID
- BAD_REQUEST
- UNAUTHORIZED
- RATE_LIMIT_EXCEEDED
message:
type: string
description: A human-readable error message.
status:
type: integer
description: The HTTP status code.
examples:
- 400
- 401
- 404
- 429
example: example_value
AssetUploadResponse:
type: object
properties:
assetID:
type: string
description: The unique identifier for the uploaded asset.
examples:
- urn:aaid:AS:UE1:23456789-abcd-1234-efgh-567890abcdef
uploadUri:
type: string
format: uri
description: The pre-signed URI to upload the file content via HTTP PUT. Valid for a limited time.
example: https://www.example.com
AssetUploadRequest:
type: object
required:
- mediaType
properties:
mediaType:
type: string
description: The MIME type of the file being uploaded.
examples:
- application/pdf
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- image/jpeg
responses:
BadRequest:
description: The request was malformed or contained invalid parameters. Check the error message for details.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
TooManyRequests:
description: Rate limit exceeded. Wait before retrying. Check Retry-After header for guidance.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
NotFound:
description: The requested resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Authentication failed. The access token is missing, expired, or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
parameters:
assetID:
name: assetID
in: path
required: true
description: The unique identifier of the asset.
schema:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: OAuth 2.0 access token obtained via client credentials grant from Adobe Identity Management Service (IMS). Generate credentials in the Adobe Developer Console and exchange them for an access token at https://ims-na1.adobelogin.com/ims/token/v3.
x-refined-from:
- adobe-pdf-services-api-openapi-official.json
- adobe-pdf-services-api-openapi.yml