Skills
Authorizations
Path parameters
workspaceIdstringRequired
Query parameters
limitinteger · min: 1 · max: 100OptionalDefault:
Limits the number of results to return
10
pageTokenstringOptional
Pagination token that keeps of track of the current position in the list
reversebooleanOptionalDefault:
Order in which to retrieve the results
false
Responses
200
A paginated list of agent skills.
application/json
Responseall of
get
GET /workspaces/{workspaceId}/inbox/skills HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
200
A paginated list of agent skills.
{
"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-07-12T01:54:35.110Z"
}
],
"createdAt": "2025-07-12T01:54:35.110Z",
"updatedAt": "2025-07-12T01:54:35.110Z",
"createdBy": "123e4567-e89b-12d3-a456-426614174000",
"updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}
]
}
Authorizations
Path parameters
workspaceIdstringRequired
Body
CreateAgentSkill is the request body for creating a new AgentSkill.
namestringRequired
descriptionstringRequired
valueTypestring · enumRequiredPossible values:
AgentSkillValueType defines how can the Values of a Skill can be selected.
Responses
201
The agent skill.
application/json
404
Workspace not found
application/json
409
Agent Skill with that name already exists
application/json
422
Invalid input
application/json
post
POST /workspaces/{workspaceId}/inbox/skills HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 99
{
"name": "text",
"description": "text",
"valueType": "single",
"values": [
{
"value": "text",
"icon": "text"
}
]
}
{
"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-07-12T01:54:35.110Z"
}
],
"createdAt": "2025-07-12T01:54:35.110Z",
"updatedAt": "2025-07-12T01:54:35.110Z",
"createdBy": "123e4567-e89b-12d3-a456-426614174000",
"updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}
Authorizations
Path parameters
workspaceIdstringRequired
agentSkillIdstring · uuidRequired
Responses
200
The agent skill.
application/json
404
Workspace or Agent Skill not found
application/json
get
GET /workspaces/{workspaceId}/inbox/skills/{agentSkillId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"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-07-12T01:54:35.110Z"
}
],
"createdAt": "2025-07-12T01:54:35.110Z",
"updatedAt": "2025-07-12T01:54:35.110Z",
"createdBy": "123e4567-e89b-12d3-a456-426614174000",
"updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}
Authorizations
Path parameters
workspaceIdstringRequired
agentSkillIdstring · uuidRequired
Body
UpdateAgentSkill is the request body for updating an existing AgentSkill.
namestring | nullableOptional
descriptionstring | nullableOptional
valueTypestring · enum | nullableOptionalPossible values:
AgentSkillValueType defines how can the Values of a Skill can be selected.
Responses
200
The agent skill.
application/json
404
Workspace or Agent Skill not found
application/json
409
Agent Skill with that name already exists
application/json
422
Invalid input
application/json
patch
PATCH /workspaces/{workspaceId}/inbox/skills/{agentSkillId} HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 182
{
"name": "text",
"description": "text",
"valueType": "single",
"values": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"value": "text",
"icon": "text",
"createdAt": "2025-07-12T01:54:35.110Z"
}
]
}
{
"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-07-12T01:54:35.110Z"
}
],
"createdAt": "2025-07-12T01:54:35.110Z",
"updatedAt": "2025-07-12T01:54:35.110Z",
"createdBy": "123e4567-e89b-12d3-a456-426614174000",
"updatedBy": "123e4567-e89b-12d3-a456-426614174000"
}
Authorizations
Path parameters
workspaceIdstringRequired
agentSkillIdstring · uuidRequired
Responses
204
OK
404
Workspace or Agent Skill not found
application/json
delete
DELETE /workspaces/{workspaceId}/inbox/skills/{agentSkillId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
Last updated
Was this helpful?