Skip to main content
POST
/
resources
curl -X POST 'https://api.example.com/resources' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "resourceTypeId": "resource_type_document",
    "scopeId": "scope_engineering",
    "externalResourceId": "doc-123",
    "displayName": "Project Roadmap"
  }'

{
  "id": "resource_0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "resourceTypeId": "resource_type_document",
  "scopeId": "scope_engineering",
  "externalResourceId": "doc-123",
  "displayName": "Project Roadmap",
  "createdAt": "2024-01-15T10:30:00Z",
  "createdBy": "system"
}

​
Request Body

​
id
string
Optional client-provided ID. Format: resource_{uuidv7}
​
resourceTypeId
string
required
ID of the resource type
​
scopeId
string
required
ID of the owning scope
​
externalResourceId
string
required
External identifier for the resource
​
displayName
string
Display name for the resource

​
Response

Returns the created resource object. 
curl -X POST 'https://api.example.com/resources' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "resourceTypeId": "resource_type_document",
    "scopeId": "scope_engineering",
    "externalResourceId": "doc-123",
    "displayName": "Project Roadmap"
  }'

{
  "id": "resource_0190a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "resourceTypeId": "resource_type_document",
  "scopeId": "scope_engineering",
  "externalResourceId": "doc-123",
  "displayName": "Project Roadmap",
  "createdAt": "2024-01-15T10:30:00Z",
  "createdBy": "system"
}