Skills

List Agent Skills

GET/workspaces/{workspaceId}/inbox/skills
Authorization
Path parameters
workspaceId*string
Query parameters
Response

A paginated list of agent skills.

Body
nextPageTokenstring

The token to fetch the next page of results. If empty, there are no more results to fetch.

results*array of AgentSkill (object)
Request
const response = await fetch('/workspaces/{workspaceId}/inbox/skills', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer jwt"
    },
});
const data = await response.json();
Response
{
  "nextPageToken": "text",
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "valueType": "single",
      "values": [
        {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "value": "text",
          "icon": "text",
          "createdAt": "2025-01-21T01:28:55.703Z"
        }
      ],
      "createdAt": "2025-01-21T01:28:55.703Z",
      "updatedAt": "2025-01-21T01:28:55.703Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000",
      "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Create Agent Skill

POST/workspaces/{workspaceId}/inbox/skills
Authorization
Path parameters
workspaceId*string
Body
name*string
description*string
valueType*AgentSkillValueType (enum)

AgentSkillValueType defines how can the Values of a Skill can be selected.

singlemultipleboolean
values*array of object
Response

The agent skill.

Body
id*string (uuid)
workspaceId*string (uuid)
name*string
description*string
valueType*AgentSkillValueType (enum)

AgentSkillValueType defines how can the Values of a Skill can be selected.

singlemultipleboolean
values*array of AgentSkillValue (object)
createdAt*string (date-time)
updatedAt*string (date-time)
createdBy*string (uuid)
updatedBy*string (uuid)
Request
const response = await fetch('/workspaces/{workspaceId}/inbox/skills', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer jwt",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "text",
      "description": "text",
      "valueType": "single",
      "values": [
        {
          "value": "text",
          "icon": "text"
        }
      ]
    }),
});
const data = await response.json();
Response
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "valueType": "single",
  "values": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "value": "text",
      "icon": "text",
      "createdAt": "2025-01-21T01:28:55.703Z"
    }
  ],
  "createdAt": "2025-01-21T01:28:55.703Z",
  "updatedAt": "2025-01-21T01:28:55.703Z",
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}

Get Agent Skill

GET/workspaces/{workspaceId}/inbox/skills/{agentSkillId}
Authorization
Path parameters
workspaceId*string
agentSkillId*string (uuid)
Response

The agent skill.

Body
id*string (uuid)
workspaceId*string (uuid)
name*string
description*string
valueType*AgentSkillValueType (enum)

AgentSkillValueType defines how can the Values of a Skill can be selected.

singlemultipleboolean
values*array of AgentSkillValue (object)
createdAt*string (date-time)
updatedAt*string (date-time)
createdBy*string (uuid)
updatedBy*string (uuid)
Request
const response = await fetch('/workspaces/{workspaceId}/inbox/skills/{agentSkillId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer jwt"
    },
});
const data = await response.json();
Response
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "valueType": "single",
  "values": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "value": "text",
      "icon": "text",
      "createdAt": "2025-01-21T01:28:55.703Z"
    }
  ],
  "createdAt": "2025-01-21T01:28:55.703Z",
  "updatedAt": "2025-01-21T01:28:55.703Z",
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}

Update Agent Skill

PATCH/workspaces/{workspaceId}/inbox/skills/{agentSkillId}
Authorization
Path parameters
workspaceId*string
agentSkillId*string (uuid)
Body
namenullable string
descriptionnullable string
valueTypeAgentSkillValueType (enum)

AgentSkillValueType defines how can the Values of a Skill can be selected.

singlemultipleboolean
valuesarray of object
Response

The agent skill.

Body
id*string (uuid)
workspaceId*string (uuid)
name*string
description*string
valueType*AgentSkillValueType (enum)

AgentSkillValueType defines how can the Values of a Skill can be selected.

singlemultipleboolean
values*array of AgentSkillValue (object)
createdAt*string (date-time)
updatedAt*string (date-time)
createdBy*string (uuid)
updatedBy*string (uuid)
Request
const response = await fetch('/workspaces/{workspaceId}/inbox/skills/{agentSkillId}', {
    method: 'PATCH',
    headers: {
      "Authorization": "Bearer jwt",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();
Response
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "description": "text",
  "valueType": "single",
  "values": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "value": "text",
      "icon": "text",
      "createdAt": "2025-01-21T01:28:55.703Z"
    }
  ],
  "createdAt": "2025-01-21T01:28:55.703Z",
  "updatedAt": "2025-01-21T01:28:55.703Z",
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}

Delete Agent Skill

DELETE/workspaces/{workspaceId}/inbox/skills/{agentSkillId}
Authorization
Path parameters
workspaceId*string
agentSkillId*string (uuid)
Response

OK

Request
const response = await fetch('/workspaces/{workspaceId}/inbox/skills/{agentSkillId}', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer jwt"
    },
});
const data = await response.json();
Response
{
  "code": "text",
  "message": "text"
}

Last updated