Project Management

Create Project Object

Use this API to create a new Project object record.

🗒 Things to Know

  • This API only supports creating Project objects via Object Manager.
post/api/custom-entity/v1/projects

Request

  • Base URL
    https://hostname/api/custom-entity
  • URL
    https://hostname/api/custom-entity/api/custom-entity/v1/projects
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://{hostname}/api/access/v1/oauth/token scopes: object-manager, object-manager-write, integration

Request body

namestring required

The name of the object.

descriptionstring

The description of the object.

deadlinestring date

The deadline of the project.

externalIdstring

The external identifier for the project.

projectLinkstring uri

The project link or other URL.

intendedUsestring

The intended use of the project.

businessValuestring

The business value of the project.

projectOwnerstring

The user assigned as the owner of the project.

status'Draft' | 'Active' | 'In Progress' | 'On Hold' | 'Completed' | 'Cancelled'

The status of the project.

type'AI' | 'Campaign' | 'Feature' | 'General' | 'Process' | 'Product'

The type of project.

internalOrExternal'Internal' | 'External'

This parameter indicates whether the project is internal or external.

promotionStatus'Not Promoted' | 'Promoted' | 'Promotion Pending'

The project promotion status.

additionalAttributesobject

This parameter can be used to store attribute details in key value pairs.

Example request

{
  "name": "Data Analytics Platform Development",
  "description": "Development of an enterprise-wide data analytics platform",
  "deadline": "2025-12-31",
  "externalId": "PROJ-2025-001",
  "projectLink": "https://project-tracker.example.com/projects/PROJ-2025-001",
  "status": "Active",
  "type": "Development"
}

Response

Project entity created successfully

idstring uuid required

The unique identifier of the object.

numberinteger required

The sequential order in which the object was created.

namestring required

The name of the object.

orgGroupIdstring uuid

The unique identifier of the organization responsible for the object.

schemaIdstring uuid required

The unique identifier of the schema.

attributesobject

The details of the associated attributes.

Example response

{
  "id": "f2229953-b4b5-4042-8cb9-b78038cc4c46",
  "name": "OneTrust",
  "entityType": {
    "id": "d1119953-b4b5-4042-8cb9-b78038cc2c46",
    "name": "Vendor"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.