Specs

List Specs

Every Spec in the workspace. A Spec is the authoring document behind /specs/{id} in the app; running it materializes onto a schema, and schema_id on each row is that schema — a different id from the Spec's own. Pair with spec_id on GET /v1/schemas to cross in the other direction.

get/v1/specs

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/specs
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of items to return (1–100).

cursorstring

Opaque pagination cursor from a previous response's pagination.next_cursor.

order'asc' | 'desc'

Sort order by creation date.

searchstring

Case-insensitive name search.

Response

Paginated list of Specs.

Example response

{
  "data": [
    {
      "id": "e2144027-39c0-44e8-a196-72be1e360749",
      "name": "Bridgeway V25",
      "schema_id": "2e3ddf8c-b9ab-4934-bb11-a371e9c5d7a8",
      "version": 3,
      "materialized_version": 3,
      "field_count": 60,
      "node_count": 7
    }
  ],
  "pagination": {
    "total": 142,
    "limit": 20,
    "has_more": true,
    "next_cursor": "ZDFhMmIzYzR8MjAyNi0wNC0wM1QxMjowMDowMC4wMDBa"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.