Releases

GET /releases

List releases for the org. By default, shipped / production / done / released releases are hidden — pass show_done=true to include them.

Query parameters

Request

curl -sS "$BASE_URL/releases?project_id=42" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "releases": [
      {
        "id": 17,
        "org_id": 1,
        "project_id": 42,
        "product_id": 7,
        "name": "v2.4 Feature Push",
        "version": "2.4",
        "rc_number": "1",
        "status": "in_progress",
        "qa_status": "not_started",
        "comments": "RC1 — covers cards through Friday",
        "project_name": "Web App",
        "product_name": "Tasklife",
        "task_count": 12,
        "created_at": "2026-07-22 14:08:11",
        "updated_at": "2026-07-26 09:31:02"
      }
    ]
  }
}

POST /releases

Create a new release. The authenticated user (from the API key) is recorded as created_by.

Body parameters

Request

curl -sS -X POST "$BASE_URL/releases" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": 42,
    "product_id": 7,
    "name": "v2.4 Feature Push",
    "version": "2.4",
    "rc_number": "1",
    "comments": "RC1 — covers cards through Friday"
  }'

Response 201 Created

{
  "success": true,
  "data": {
    "id": 17
  }
}

Errors

GET /releases/{id}

Get a single release with its full task list.

Path parameters

Request

curl -sS "$BASE_URL/releases/17" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "release": {
      "id": 17,
      "org_id": 1,
      "project_id": 42,
      "product_id": 7,
      "name": "v2.4 Feature Push",
      "version": "2.4",
      "rc_number": "1",
      "status": "in_progress",
      "qa_status": "in_progress",
      "comments": "RC1 — covers cards through Friday",
      "status_settings": "{\"statuses\":[\"not_started\",\"in_progress\",\"passed\",\"failed\",\"shipped\"],\"qa_statuses\":[\"not_started\",\"in_progress\",\"passed\",\"failed\"]}",
      "created_by": 8,
      "created_at": "2026-07-22 14:08:11",
      "updated_at": "2026-07-26 09:31:02",
      "project_name": "Web App",
      "product_name": "Tasklife",
      "tasks": [
        {
          "id": 1284,
          "title": "Add OAuth device grant endpoint",
          "task_status": "Done",
          "project_id": 42,
          "project_column_id": 91,
          "column_name": "Done"
        },
        {
          "id": 1301,
          "title": "Auto-bump APP_VERSION on CSS/JS edits",
          "task_status": "In Progress",
          "project_id": 42,
          "project_column_id": 90,
          "column_name": "In Progress"
        }
      ]
    }
  }
}

Errors

PUT /releases/{id}

Update one or more fields on a release. Only the fields you include in the body are changed.

Path parameters

Body parameters

All optional. At least one field is required.

Request

curl -sS -X PUT "$BASE_URL/releases/17" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rc_number": "2",
    "status": "in_progress",
    "comments": "RC2 — addressing feedback from RC1"
  }'

Response 200 OK

{
  "success": true
}

Errors

DELETE /releases/{id}

Delete a release. Cascades the release_tasks join rows and clears the release_id back-reference on every attached task so tasks aren't orphaned to a deleted id.

Path parameters

Request

curl -sS -X DELETE "$BASE_URL/releases/17" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{ "success": true }

Errors

POST /releases/{id}/tasks

Attach a task to a release. The task must belong to the same project as the release. The task's own release_id field is set as a back-reference, so the task shows up under the release in the task UI too. Idempotent — re-adding an already-attached task is a no-op.

Path parameters

Body parameters

Request

curl -sS -X POST "$BASE_URL/releases/17/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "task_id": 1301 }'

Response 200 OK

{ "success": true }

Errors

DELETE /releases/{id}/tasks/{taskId}

Detach a task from a release. Removes the release_tasks join row and clears the task's own release_id back-reference. Idempotent — no error if the task wasn't attached.

Path parameters

Request

curl -sS -X DELETE "$BASE_URL/releases/17/tasks/1301" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{ "success": true }

Errors

GET /releases/{id}/tasks/search

Search tasks by title within a release's project. Used by the in-app autocomplete picker; returns up to 20 matches, ordered by title ascending. Useful when you have a release id and want to find task ids to attach.

Path parameters

Query parameters

Request

curl -sS "$BASE_URL/releases/17/tasks/search?q=oauth" \
  -H "Authorization: Bearer $API_KEY"

Response 200 OK

{
  "success": true,
  "data": {
    "tasks": [
      {
        "id": 1284,
        "title": "Add OAuth device grant endpoint",
        "column_name": "Done"
      },
      {
        "id": 1411,
        "title": "OAuth token refresh bug on slow clocks",
        "column_name": "In Progress"
      }
    ]
  }
}

Errors