Skip to main content
GET
/
v1
/
groups
List groups
curl --request GET \
  --url https://api.production.xtrace.ai/v1/groups \
  --header 'X-Org-Id: <api-key>' \
  --header 'x-api-key: <api-key>'
{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "prompt": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "object": "group",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Long-lived org API key. Alternative: Authorization: Bearer <key>.

​
X-Org-Id
string
header
required

Required alongside the API key (no key→org reverse index).

Query Parameters

​
include_archived
boolean
default:false

When true, the response includes archived groups in addition to active ones. Default false — most callers only need the currently-taggable set.

Response

Successful Response

Stripe-style list envelope. No cursor for now — group count is bounded by Settings.MAX_GROUPS_PER_ORG (default 100) so a single page is always sufficient.

​
object
string
default:list

Constant discriminator for the resource type.

Allowed value: "list"
​
data
Group · object[]

All matching groups in the org.