Error
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "skl_71ab",
"agentId": "agt_4f9c2b7e10a24d51",
"organizationId": "org_2a1b9c",
"name": "send_service_request",
"description": "Email the dispatch team a new service request once details are gathered.",
"skillType": "email",
"requiredParams": [
"customer_name",
"address",
"problem"
],
"executionConfig": {
"to": "dispatch@peakcomforthvac.com",
"subject": "New service request — {customer_name}"
},
"isWrite": true
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Skills
Get a skill
Returns the full configuration of a single skill on an agent.
GET
/
agents
/
{agentId}
/
skills
/
{id}
Error
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "skl_71ab",
"agentId": "agt_4f9c2b7e10a24d51",
"organizationId": "org_2a1b9c",
"name": "send_service_request",
"description": "Email the dispatch team a new service request once details are gathered.",
"skillType": "email",
"requiredParams": [
"customer_name",
"address",
"problem"
],
"executionConfig": {
"to": "dispatch@peakcomforthvac.com",
"subject": "New service request — {customer_name}"
},
"isWrite": true
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
FlowClient Credentials
- Token URL
- /api/v1/api-keys
Scopes1
skills:read
Read skills & skill-types.
Path Parameters
The agent this resource is scoped to (the UUID returned by createAgent / listAgents).
The skill's id (from listSkills / createSkill).