Documentation menu
Definitions

Create an immutable Definition revision

POST /api/v1/projects/{projectId}/definitions/{definitionId}/revisions

Validates and stores a new immutable Definition revision under the resolved Project and Definition. The source and attachment graph are captured at creation; a prior revision is never edited or implicitly released. Invalid source or attachment data returns 422, and an unknown or foreign target returns 404.

Parameters

path

NameTypeRequiredDescription
projectIdstringrequiredIdentifies the Project that owns the addressed resource. Applies to Create an immutable Definition revision.
definitionIdstringrequiredIdentifies the definition element being addressed. Applies to Create an immutable Definition revision.

Request body

Required — Request body for: Create an immutable Definition revision.

application/json

NameTypeRequiredDescription
sourceobjectrequired
attachmentsarray<object>optional

Responses

StatusDescriptionBody
201Response for status 201application/json — object — id: string (required); definitionId: string (required); number: integer (required); source: object (required); createdByUserId: string (required); attachments: array<object> (required)
400The request is malformed or cannot be processed.application/json — PublicApiError — error: object (required)
401Authentication failed. The Authorization header is missing, or the credential is invalid or expired.application/json — PublicApiError — error: object (required)
403Access denied. The authenticated user does not have permission to perform this action.application/json — PublicApiError — error: object (required)
404Resource not found.application/json — PublicApiError — error: object (required)
409Request conflicts with current state of the resource, including safe deployment conflict classifications.application/json — PublicApiError — error: object (required)
422Request validation failed. Check the request body, query parameters, or path parameters.application/json — PublicApiError — error: object (required)
429Too many requests.application/json — PublicApiError — error: object (required)
500The server could not complete the request.application/json — PublicApiError — error: object (required)
503Service temporarily unavailable (e.g. execution capacity exhausted). The response carries a Retry-After header; retry with backoff.application/json — PublicApiError — error: object (required)