Buffers
Browse and manage classification buffers
/api/v0/buffersList buffers
Retrieve a paginated list of buffers with input counts.
Page number (1-indexed)
Number of results per page (1–100)
List of buffers in this organization
Unique identifier for the buffer
Display name of the buffer
URL-safe identifier used in API paths
Optional description of what feedback this buffer collects
Optional emoji or icon identifier for display purposes
Number of inputs currently assigned to this buffer
Number of nested child buffers
ISO 8601 timestamp when the buffer was created
Current page number (1-indexed)
Number of items per page
Total number of items across all pages
Total number of pages
/api/v0/buffersCreate buffer
Create a new buffer. The slug is automatically generated from the name and guaranteed to be unique within your organization.
Request Body*
Display name for the buffer.
Optional description of what this buffer collects.
Optional icon identifier (emoji or icon name).
Unique identifier for the buffer
Display name of the buffer
URL-safe identifier used in API paths
Optional description of what feedback this buffer collects
Optional emoji or icon identifier for display purposes
Number of inputs currently assigned to this buffer
Number of nested child buffers
ISO 8601 timestamp when the buffer was created
Instructions that guide AI classification into this buffer.
ISO 8601 timestamp when the buffer was last modified
Error details object
Machine-readable error code identifying the failure type
Human-readable description of the error
/api/v0/buffers/{bufferId}Get buffer
Retrieve a single buffer by ID.
Short ID of the buffer
Unique identifier for the buffer
Display name of the buffer
URL-safe identifier used in API paths
Optional description of what feedback this buffer collects
Optional emoji or icon identifier for display purposes
Number of inputs currently assigned to this buffer
Number of nested child buffers
ISO 8601 timestamp when the buffer was created
Instructions that guide AI classification into this buffer.
ISO 8601 timestamp when the buffer was last modified
/api/v0/buffers/{bufferId}Update buffer
Partially update a buffer. Only include fields you want to change.
Short ID of the buffer
Request Body*
Display name for the buffer.
Optional description of what this buffer collects.
Optional icon identifier (emoji or icon name).
Optional instructions to guide AI classification into this buffer.
Unique identifier for the buffer
Display name of the buffer
URL-safe identifier used in API paths
Optional description of what feedback this buffer collects
Optional emoji or icon identifier for display purposes
Number of inputs currently assigned to this buffer
Number of nested child buffers
ISO 8601 timestamp when the buffer was created
Instructions that guide AI classification into this buffer.
ISO 8601 timestamp when the buffer was last modified
/api/v0/buffers/{bufferId}Delete buffer
Soft-delete a buffer (sets archived = true). Inputs assigned to this buffer are not deleted.
Short ID of the buffer
Always true when the buffer was successfully deleted
/api/v0/buffers/{bufferId}/move-allMove all inputs to another buffer
Move every input currently assigned to this buffer into a different target buffer.
Short ID of the source buffer
Request Body*
Short ID of the buffer to move inputs into. Must be different from the source buffer.
Number of inputs moved to the target buffer