Slices

A slice is a bug report in Brie. It contains a summary, description, priority, status, labels, and optionally captured context like screenshots, console logs, and network requests.

Response fields

Field	Type	Description
`id`	string	Unique slice ID
`summary`	string \| null	Short title
`description`	string \| null	Detailed description
`priority`	string \| null	`LOW`, `MEDIUM`, `HIGH`, `HIGHEST`, `LOWEST`
`status`	string \| null	`CREATED`, `IN_PROGRESS`, `COMPLETED`, `DRAFT`, etc.
`labels`	object[]	Array of `{ id, text }` label objects
`isPublic`	boolean	Whether the slice is publicly shared
`createdAt`	string	ISO 8601 timestamp
`updatedAt`	string	ISO 8601 timestamp
`reporter`	object	`{ id, firstName, lastName }` — the user who created the slice
`workspace`	object	`{ id, name }` — the workspace the slice belongs to

List slices

GET /v1/slices

Scope: slices:read

Parameter	Type	Description
`workspaceId`	string	Filter by workspace (required for WST tokens)
`spaceId`	string	Filter by space
`status`	string	Filter by status (`CREATED`, `IN_PROGRESS`, `COMPLETED`, `DRAFT`, `REPORTED`, etc.)
`priority`	string	Filter by priority (`LOW`, `MEDIUM`, `HIGH`, `HIGHEST`, `LOWEST`)
`sort`	string	Sort field: `createdAt` or `updatedAt` (default: `createdAt`)
`order`	string	Sort order: `asc` or `desc` (default: `desc`)
`cursor`	string	Pagination cursor from previous response
`limit`	number	Results per page, 1–100 (default: 25)

Example:

curl "https://api.briehq.com/v1/slices?workspaceId=ws_123&status=CREATED&limit=10" \
  -H "Authorization: Bearer brie_pat_xxx"

Get a slice

GET /v1/slices/:id

Scope: slices:read

Create a slice

POST /v1/slices

Scope: slices:write

Field	Type	Required	Description
`summary`	string	No	Short title of the bug (max 125 chars)
`description`	string	No	Detailed description (Markdown supported)
`workspaceId`	string	No	Target workspace (required for WST tokens)
`spaceId`	string	No	Target space within the workspace
`priority`	string	No	`LOW`, `MEDIUM`, `HIGH`, `HIGHEST`, `LOWEST`
`labels`	object[]	No	Array of `{ id: string, text: string }` label objects

Example:

curl -X POST https://api.briehq.com/v1/slices \
  -H "Authorization: Bearer brie_pat_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "summary": "Login button broken on Safari",
    "workspaceId": "ws_123",
    "priority": "HIGH",
    "labels": [{ "id": "uuid-1", "text": "safari" }, { "id": "uuid-2", "text": "auth" }]
  }'

Supports idempotency via the Idempotency-Key header — send the same key twice to avoid duplicate slices.

Update a slice

PATCH /v1/slices/:id

Scope: slices:write

Field	Type	Description
`summary`	string	Updated title (max 125 chars)
`description`	string	Updated description
`priority`	string	Updated priority
`status`	string	Updated status (`CREATED`, `IN_PROGRESS`, `COMPLETED`, `DRAFT`, etc.)
`labels`	object[]	Replaces existing labels (`{ id: string, text: string }` objects)
`isPublic`	boolean	Toggle public sharing

Delete a slice

DELETE /v1/slices/:id

Scope: slices:delete

Returns 204 No Content with no response body. This is a soft delete.