Projects

Get Paginated List of Projects

Changed on

This endpoint returns a paginated list of all Projects within the organization's ESM shared storage that the requester is authorized to access.

NOTE:

  • Includes only CC Projects.
  • The response supports cursor-based pagination and includes a nextUrl field when additional pages are available.
  • If there are no further results, the nextUrl field is omitted.
  • Each item in the response provides basic metadata about the project.
get/projects

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/projects
  • Auth: HTTP bearer

Query parameters

limitinteger
  • Provides a hint for the number of items per page.
  • In cases where multiple elements have the same field value used to split the page, the server may adjust the number of items returned to ensure page boundaries align correctly.
cursorstring

Cursor used for fetching next set of results.

  • If not provided, the first page of results is returned.
  • For subsequent pages, only the cursor should be sent.

NOTE:
The cursor is opaque and should not be parsed or modified by clients.

sortBystring

Defines the sort order.

  • If not specified, the default is +name.
  • Prefix with - for descending order. + is optional for ascending order.

Following fields are supported for sorting:

  • name
  • created

NOTE:

  • Only applicable for the first page. Subsequent pages must use the cursor.
filterstring

FIQL-based filter string

Following fields are supported for filtering:

  • state: Filter by asset state (operators allowed are ==). Single value is only supported.

    • active (default): Filter by active assets.
    • deleted: Filter by (soft)deleted assets.

  • createdBy: Filter by project creator (operators allowed are == and !=). Single value is only supported.

    • current_user is a predefined constant representing the user initiating the request. Currently, this is the sole supported value.

NOTE:

  • Only applicable for the first page. Subsequent pages must use the cursor.

Headers

x-request-idstring
Example:1234567890

The X-Request-Id header is used to identify a request.
It can be used to correlate logs and other resources and is intended to be a non-persistent identifier.

Response

Success - Paginated response containing an array of project assets with basic information about the project along with paging information.

Example response

{
  "paging": {
    "limit": 10,
    "nextUrl": "https://api.example.com/assets?cursor=550e8400-e29b-41d4-a716-446655440000&limit=10"
  },
  "items": [
    {
      "assetId": "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
      "name": "My Asset",
      "createdDate": "2021-01-01T00:00:00Z",
      "modifiedDate": "2021-01-01T00:00:00Z",
      "createdBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
      "modifiedBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
      "path": "/My Project/My Folder/My Asset",
      "ancestors": [
        "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
        "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a175",
        "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a176"
      ]
    }
  ]
}

Changes

  • 240b6278279cRevision changes
    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new conflict enum value to the response property for the response status

  • 01600f5358e9Revision changes
    • warning

      added the new deleted enum value to the /// response property for the response status

    • warning

      added the new deleted_parent enum value to the /// response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new operation_timeout enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new payload_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • warning

      added the new resource_too_large enum value to the response property for the response status

    • info

      removed the discarded enum value from the /// response property for the response status

    • info

      removed the discarded_parent enum value from the /// response property for the response status