Create Build Step

Developing

POST

/api/tasks/{task}/build-steps

Create a new build step for a specific task. Validated by BuildStepRequest: name is required (max 255 chars), text and sort are optional. Returns the created BuildStepResource.

Permission: view tasks (route inherits from parent tasks group)

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.commandroom.ai/api/api/tasks/42/build-steps' \
--header 'X-Tenant-Uuid: ' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Tenant-UUID: ' \
--header 'Content-Type: application/json' \
--data '{
  "name": "Sample Name",
  "text": "string",
  "sort": 1
}'

Response Example

201 - OK

{
  "data": {
    "id": 1,
    "task_id": 1,
    "name": "Sample Name",
    "sort": 1,
    "created_at": "2026-01-15T10:30:00.000000Z",
    "updated_at": "2026-01-15T10:30:00.000000Z"
  }
}

Modified at 2026-07-02 04:47:16

GET Build Steps (index)

GET Item (show)