Projects

Create a new project.

Changed on

This endpoint creates a new CC Project within the organization's ESM shared storage, provided the user has the necessary permissions.

post/projects

Request

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

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.

Request body

namestring required

The name of the asset (including the extension, in case of a file)

The name must not be a

  • reserved Windows name
    • CON
    • PRN
    • AUX
    • NUL
    • COM1 through COM9
    • LPT1 through LPT9
  • contain any of the following characters:
    • \
    • /
    • :
    • *
    • ?
    • "
    • |
    • >
    • <

Example request

{
  "options": {
    "autorename": true
  }
}

Response

Created - The project was created successfully.

assetIdstring required

A globally unique identifier for the asset

namestring required

Human-readable name of the asset

createdDatestring date-time
modifiedDatestring date-time
createdBystring

The Unique ID for the principal in the system

modifiedBystring

The Unique ID for the principal in the system

pathstring

The path of the asset from the parent collection.

ancestorsAssetId[]

Ordered list of ancestor asset IDs (first is immediate parent).

state'active' | 'deleted' | 'deleted_parent'

Current state of the asset

assetTypestring required

Example response

{
  "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
    • breaking

      added the pattern ^(?!^([Cc][Oo][Nn]|[Pp][Rr][Nn]|[Aa][Uu][Xx]|[Nn][Uu][Ll]|[Cc][Oo][Mm][1-9]|[Ll][Pp][Tt][1-9])$)[^\\\/:*?"|><]+$ to the request property

    • 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

    • 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

    • info

      the request property's minLength was decreased from 1 to 0

  • 01600f5358e9Revision changes
    • breaking

      the mandatory response header etag removed for the status 201

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

    • 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

      added the new optional request property

    • 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