Skip to content

Estimates overview ​

Estimates define the sizing scale a project uses.

The estimate object ​

Attributes ​

  • created_at string (date-time)

    When the record was created.

  • created_by_id string (uuid)

    The user who created the record.

  • description string

    Free-form description.

  • external_id string

    Your system's identifier for this record, for sync and import correlation.

  • external_source string

    The system external_id came from, for example github or jira.

  • id string (uuid)

    Unique identifier.

  • last_used boolean

    Whether last used.

  • name string

    Display name.

  • type string

    The type.

Response200
json
{
  "created_at": "2026-01-14T09:22:41.478363Z",
  "created_by_id": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  "description": "What this is for.",
  "external_id": null,
  "external_source": null,
  "id": "b7e42a19-3c5d-4f80-9a26-8d1c0f4e7b53",
  "last_used": false,
  "name": "Example name",
  "type": "categories"
}

Endpoints ​

MethodPathDescription
GET/api/v2/workspaces/{slug}/projects/{project_id}/estimates/List estimates
GET/api/v2/workspaces/{slug}/projects/{project_id}/estimates/{pk}/Get an estimate
POST/api/v2/workspaces/{slug}/projects/{project_id}/estimates/Create an estimate
PATCH/api/v2/workspaces/{slug}/projects/{project_id}/estimates/{pk}/Update an estimate
DELETE/api/v2/workspaces/{slug}/projects/{project_id}/estimates/{pk}/Delete an estimate
POST/api/v2/workspaces/{slug}/projects/{project_id}/estimates/upsert/Upsert an estimate
POST/api/v2/workspaces/{slug}/projects/{project_id}/estimates/bulk-create/Bulk create estimates
POST/api/v2/workspaces/{slug}/projects/{project_id}/estimates/bulk-update/Bulk update estimates
POST/api/v2/workspaces/{slug}/projects/{project_id}/estimates/bulk-delete/Bulk delete estimates

Response shaping ​

Every estimate read accepts ?fields= for sparse responses — see Sparse fields. Errors follow the shared problem+json contract.