List skills

List skills invocable in the authenticated teamspace. Returns built-ins, Public custom skills that are unrestricted or assigned here, and the API-key subject’s own Private skills assigned here. Other users’ Private skills and unassigned Private skills are excluded. Built-in skills your company removed are excluded, and a built-in your company disabled is returned with enabled: false.

GET /skills

List skills

Python

import requests

url = "https://api.datagrid.com/v1/skills"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "object": "list",
  "data": [
    {
      "object": "skill",
      "id": "<string>",
      "scope": "user",
      "category": "document_analysis",
      "slash_key": "<string>",
      "name": "<string>",
      "description": "<string>",
      "instructions": "<string>",
      "required_tools": [
        "<string>"
      ],
      "preferred_tools": [
        "<string>"
      ],
      "enabled": true,
      "account_id": "<string>",
      "builtin_key": "<string>",
      "promoted_at": "2023-11-07T05:31:56Z",
      "creator_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

search · string

Optional search string to filter skills by name or slash key. Case-insensitive partial match.

Maximum string length: 255

enabled · boolean

Filter by enabled status.

scope · enum<string>

Return only skills of this scope. user returns the API-key subject's own Private skills assigned to the authenticated teamspace; account returns Public custom skills invocable here; teamspace is a deprecated legacy Public value that remains assignment-required until normalized by a privacy or assignment action; and builtin is the global catalogue. Omit to return everything the caller can invoke.

Available options: user, account, teamspace, builtin

limit · integer · default: 50

The limit on the number of objects to return, ranging between 1 and 100.

Required range: 1 <= x <= 100

after · string

A cursor to use in pagination. after is an object ID that defines your place in the list. For example, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo to fetch the next page of the list.

before · string

A cursor to use in pagination. before is an object ID that defines your place in the list. For example, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include before=obj_bar to fetch the previous page of the list.

Response

200

application/json

List of skills

object · enum<string> · required

The object type, always 'list'.

Available options: list

data · object[] · required

Array of skill objects.

Show child attributes

has_more · boolean · required

Whether there are more results available.