Skills

List skills

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/

List skills for a workspace with pagination. Optionally filter by enabled status. Requires Skill.view permission.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Query parameters

enabledany ofOptional

booleanOptional

or

nullOptional

execution_tierany ofOptional

stringOptional

or

nullOptional

sort_byany ofOptional

stringOptional

or

nullOptional

limitinteger · max: 20OptionalDefault: 10

continuation_tokenintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

has_morebooleanRequired

continuation_tokenany ofOptional

integerOptional

or

nullOptional

401

Missing or invalid API key.

403

Insufficient permissions.

422

Validation Error

application/json

get

/v1/{workspace_id}/skills/

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/skills/ HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "workspace_id": "text",
      "slug": "text",
      "name": "text",
      "description": "text",
      "system_prompt": "text",
      "input_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "result_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "model": "text",
      "max_tokens": 1,
      "max_result_chars": 1,
      "max_input_tokens": 1,
      "timeout_s": 1,
      "thinking_effort": "low",
      "enable_caching": true,
      "enable_citations": true,
      "use_structured_output": true,
      "integration_tools": [
        {
          "integration": "text",
          "endpoint": "text"
        }
      ],
      "static_tools": [
        {
          "name": "text",
          "description": "text",
          "input_schema": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "handler": "text"
        }
      ],
      "delivery": "interrupt",
      "urgency_keywords": [
        "text"
      ],
      "enabled": true,
      "execution_tier": "direct",
      "max_agent_turns": 1,
      "checkpoint_enabled": true,
      "approval_required": true,
      "browser_start_url": "text",
      "browser_allowed_domains": [
        "text"
      ],
      "browser_auth_integration": "text",
      "version": 1,
      "created_at": "2026-03-22T05:27:56.864Z",
      "updated_at": "2026-03-22T05:27:56.864Z"
    }
  ],
  "has_more": true,
  "continuation_token": 1
}

Create a skill

post

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/

Create a new companion agent skill in a workspace. Requires Skill.create permission.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Body

application/json

slugstringRequired

namestring · min: 1Required

descriptionstring · min: 1Required

system_promptany ofOptional

string · min: 1Optional

or

nullOptional

result_schemaany ofOptional

or

nullOptional

modelstringOptionalDefault: claude-sonnet-4-6

max_tokensintegerOptionalDefault: 4096

max_result_charsintegerOptionalDefault: 2000

max_input_tokensany ofOptional

integerOptional

or

nullOptional

timeout_snumberOptionalDefault: 60

thinking_effortany ofOptional

string · enumOptionalPossible values:

or

nullOptional

enable_cachingbooleanOptionalDefault: true

enable_citationsbooleanOptionalDefault: false

use_structured_outputbooleanOptionalDefault: false

deliverystring · enumOptionalDefault: interruptPossible values:

urgency_keywordsstring[]OptionalDefault: []

enabledbooleanOptionalDefault: true

execution_tierstring · enumOptionalDefault: orchestratedPossible values:

max_agent_turnsintegerOptionalDefault: 20

checkpoint_enabledbooleanOptionalDefault: true

approval_requiredbooleanOptionalDefault: false

browser_start_urlany ofOptional

stringOptional

or

nullOptional

browser_allowed_domainsstring[]OptionalDefault: []

browser_auth_integrationany ofOptional

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

401

Missing or invalid API key.

403

Insufficient permissions.

404

Workspace not found.

409

Skill slug already taken or conflicts with a built-in tool name.

422

Invalid request body.

post

/v1/{workspace_id}/skills/

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/skills/ HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 844

{
  "slug": "text",
  "name": "text",
  "description": "text",
  "system_prompt": "text",
  "input_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "result_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "model": "claude-sonnet-4-6",
  "max_tokens": 4096,
  "max_result_chars": 2000,
  "max_input_tokens": 1,
  "timeout_s": 60,
  "thinking_effort": "low",
  "enable_caching": true,
  "enable_citations": false,
  "use_structured_output": false,
  "integration_tools": [
    {
      "integration": "text",
      "endpoint": "text"
    }
  ],
  "static_tools": [
    {
      "name": "text",
      "description": "text",
      "input_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "handler": "text"
    }
  ],
  "delivery": "interrupt",
  "urgency_keywords": [
    "text"
  ],
  "enabled": true,
  "execution_tier": "orchestrated",
  "max_agent_turns": 20,
  "checkpoint_enabled": true,
  "approval_required": false,
  "browser_start_url": "text",
  "browser_allowed_domains": [
    "text"
  ],
  "browser_auth_integration": "text"
}

{
  "id": "text",
  "workspace_id": "text",
  "slug": "text",
  "name": "text",
  "description": "text",
  "system_prompt": "text",
  "input_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "result_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "model": "text",
  "max_tokens": 1,
  "max_result_chars": 1,
  "max_input_tokens": 1,
  "timeout_s": 1,
  "thinking_effort": "low",
  "enable_caching": true,
  "enable_citations": true,
  "use_structured_output": true,
  "integration_tools": [
    {
      "integration": "text",
      "endpoint": "text"
    }
  ],
  "static_tools": [
    {
      "name": "text",
      "description": "text",
      "input_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "handler": "text"
    }
  ],
  "delivery": "interrupt",
  "urgency_keywords": [
    "text"
  ],
  "enabled": true,
  "execution_tier": "direct",
  "max_agent_turns": 1,
  "checkpoint_enabled": true,
  "approval_required": true,
  "browser_start_url": "text",
  "browser_allowed_domains": [
    "text"
  ],
  "browser_auth_integration": "text",
  "version": 1,
  "created_at": "2026-03-22T05:27:56.864Z",
  "updated_at": "2026-03-22T05:27:56.864Z"
}

Get a skill

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/{skill_id}

Retrieve a skill by ID. Requires Skill.view permission.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

skill_idstring · uuidRequired

Responses

200

Successful Response

application/json

idstringRequired

workspace_idstringRequired

slugstringRequired

namestringRequired

descriptionstringRequired

system_promptstringRequired

result_schemaany ofRequired

or

nullOptional

modelstringRequired

max_tokensintegerRequired

max_result_charsintegerRequired

max_input_tokensany ofRequired

integerOptional

or

nullOptional

timeout_snumberRequired

thinking_effortany ofRequired

string · enumOptionalPossible values:

or

nullOptional

enable_cachingbooleanRequired

enable_citationsbooleanRequired

use_structured_outputbooleanRequired

deliverystring · enumRequiredPossible values:

urgency_keywordsstring[]Required

enabledbooleanRequired

execution_tierstring · enumRequiredPossible values:

max_agent_turnsintegerRequired

checkpoint_enabledbooleanRequired

approval_requiredbooleanRequired

browser_start_urlany ofRequired

stringOptional

or

nullOptional

browser_allowed_domainsstring[]Required

browser_auth_integrationany ofRequired

stringOptional

or

nullOptional

versionintegerRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

401

Missing or invalid API key.

403

Insufficient permissions.

404

Skill not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/skills/{skill_id}

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/skills/{skill_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "workspace_id": "text",
  "slug": "text",
  "name": "text",
  "description": "text",
  "system_prompt": "text",
  "input_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "result_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "model": "text",
  "max_tokens": 1,
  "max_result_chars": 1,
  "max_input_tokens": 1,
  "timeout_s": 1,
  "thinking_effort": "low",
  "enable_caching": true,
  "enable_citations": true,
  "use_structured_output": true,
  "integration_tools": [
    {
      "integration": "text",
      "endpoint": "text"
    }
  ],
  "static_tools": [
    {
      "name": "text",
      "description": "text",
      "input_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "handler": "text"
    }
  ],
  "delivery": "interrupt",
  "urgency_keywords": [
    "text"
  ],
  "enabled": true,
  "execution_tier": "direct",
  "max_agent_turns": 1,
  "checkpoint_enabled": true,
  "approval_required": true,
  "browser_start_url": "text",
  "browser_allowed_domains": [
    "text"
  ],
  "browser_auth_integration": "text",
  "version": 1,
  "created_at": "2026-03-22T05:27:56.864Z",
  "updated_at": "2026-03-22T05:27:56.864Z"
}

Update a skill

put

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/{skill_id}

Update a skill's configuration. Increments version and creates an audit trail snapshot. Requires Skill.update permission.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

skill_idstring · uuidRequired

Body

application/json

nameany ofOptional

string · min: 1Optional

or

nullOptional

descriptionany ofOptional

string · min: 1Optional

or

nullOptional

system_promptany ofOptional

string · min: 1Optional

or

nullOptional

input_schemaany ofOptional

or

nullOptional

result_schemaany ofOptional

or

nullOptional

modelany ofOptional

stringOptional

or

nullOptional

max_tokensany ofOptional

integerOptional

or

nullOptional

max_result_charsany ofOptional

integerOptional

or

nullOptional

max_input_tokensany ofOptional

integerOptional

or

nullOptional

timeout_sany ofOptional

numberOptional

or

nullOptional

thinking_effortany ofOptional

string · enumOptionalPossible values:

or

nullOptional

enable_cachingany ofOptional

booleanOptional

or

nullOptional

enable_citationsany ofOptional

booleanOptional

or

nullOptional

use_structured_outputany ofOptional

booleanOptional

or

nullOptional

integration_toolsany ofOptional

or

nullOptional

static_toolsany ofOptional

or

nullOptional

deliveryany ofOptional

string · enumOptionalPossible values:

or

nullOptional

urgency_keywordsany ofOptional

string[]Optional

or

nullOptional

enabledany ofOptional

booleanOptional

or

nullOptional

execution_tierany ofOptional

string · enumOptionalPossible values:

or

nullOptional

max_agent_turnsany ofOptional

integerOptional

or

nullOptional

checkpoint_enabledany ofOptional

booleanOptional

or

nullOptional

approval_requiredany ofOptional

booleanOptional

or

nullOptional

browser_start_urlany ofOptional

stringOptional

or

nullOptional

browser_allowed_domainsany ofOptional

string[]Optional

or

nullOptional

browser_auth_integrationany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

idstringRequired

workspace_idstringRequired

slugstringRequired

namestringRequired

descriptionstringRequired

system_promptstringRequired

result_schemaany ofRequired

or

nullOptional

modelstringRequired

max_tokensintegerRequired

max_result_charsintegerRequired

max_input_tokensany ofRequired

integerOptional

or

nullOptional

timeout_snumberRequired

thinking_effortany ofRequired

string · enumOptionalPossible values:

or

nullOptional

enable_cachingbooleanRequired

enable_citationsbooleanRequired

use_structured_outputbooleanRequired

deliverystring · enumRequiredPossible values:

urgency_keywordsstring[]Required

enabledbooleanRequired

execution_tierstring · enumRequiredPossible values:

max_agent_turnsintegerRequired

checkpoint_enabledbooleanRequired

approval_requiredbooleanRequired

browser_start_urlany ofRequired

stringOptional

or

nullOptional

browser_allowed_domainsstring[]Required

browser_auth_integrationany ofRequired

stringOptional

or

nullOptional

versionintegerRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

401

Missing or invalid API key.

403

Insufficient permissions.

404

Skill not found.

422

Invalid request body.

put

/v1/{workspace_id}/skills/{skill_id}

HTTPcURLJavaScriptPython

PUT /v1/{workspace_id}/skills/{skill_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 800

{
  "name": "text",
  "description": "text",
  "system_prompt": "text",
  "input_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "result_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "model": "text",
  "max_tokens": 1,
  "max_result_chars": 1,
  "max_input_tokens": 1,
  "timeout_s": 1,
  "thinking_effort": "low",
  "enable_caching": true,
  "enable_citations": true,
  "use_structured_output": true,
  "integration_tools": [
    {
      "integration": "text",
      "endpoint": "text"
    }
  ],
  "static_tools": [
    {
      "name": "text",
      "description": "text",
      "input_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "handler": "text"
    }
  ],
  "delivery": "interrupt",
  "urgency_keywords": [
    "text"
  ],
  "enabled": true,
  "execution_tier": "direct",
  "max_agent_turns": 1,
  "checkpoint_enabled": true,
  "approval_required": true,
  "browser_start_url": "text",
  "browser_allowed_domains": [
    "text"
  ],
  "browser_auth_integration": "text"
}

{
  "id": "text",
  "workspace_id": "text",
  "slug": "text",
  "name": "text",
  "description": "text",
  "system_prompt": "text",
  "input_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "result_schema": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "model": "text",
  "max_tokens": 1,
  "max_result_chars": 1,
  "max_input_tokens": 1,
  "timeout_s": 1,
  "thinking_effort": "low",
  "enable_caching": true,
  "enable_citations": true,
  "use_structured_output": true,
  "integration_tools": [
    {
      "integration": "text",
      "endpoint": "text"
    }
  ],
  "static_tools": [
    {
      "name": "text",
      "description": "text",
      "input_schema": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "handler": "text"
    }
  ],
  "delivery": "interrupt",
  "urgency_keywords": [
    "text"
  ],
  "enabled": true,
  "execution_tier": "direct",
  "max_agent_turns": 1,
  "checkpoint_enabled": true,
  "approval_required": true,
  "browser_start_url": "text",
  "browser_allowed_domains": [
    "text"
  ],
  "browser_auth_integration": "text",
  "version": 1,
  "created_at": "2026-03-22T05:27:56.864Z",
  "updated_at": "2026-03-22T05:27:56.864Z"
}

Delete a skill

delete

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/{skill_id}

Delete a skill. SkillVersion audit trail is retained. Requires Skill.delete permission.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

skill_idstring · uuidRequired

Responses

204

Successful Response

401

Missing or invalid API key.

403

Insufficient permissions.

404

Skill not found.

422

Validation Error

application/json

delete

/v1/{workspace_id}/skills/{skill_id}

HTTPcURLJavaScriptPython

DELETE /v1/{workspace_id}/skills/{skill_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get skill references

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/{skill_id}/references

Find all HSMs and services that reference this skill's slug in their latest version's tool_call_specs. Requires Skill.view permission.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

skill_idstring · uuidRequired

Responses

200

Successful Response

application/json

skill_idstringRequired

skill_slugstringRequired

service_referencesstring[]Required

401

Missing or invalid API key.

403

Insufficient permissions.

404

Skill not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/skills/{skill_id}/references

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/skills/{skill_id}/references HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "skill_id": "text",
  "skill_slug": "text",
  "hsm_references": [
    {
      "hsm_id": "text",
      "hsm_name": "text",
      "version": 1,
      "states": [
        {
          "state_name": "text",
          "tool_spec_category": "text"
        }
      ]
    }
  ],
  "service_references": [
    "text"
  ]
}

Test a skill

post

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/skills/{skill_id}/test

Execute a skill in isolation with the given input.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

skill_idstring · uuidRequired

Body

application/json

Responses

200

Successful Response

application/json

resultstringRequired

duration_msnumberRequired

input_tokensintegerRequired

output_tokensintegerRequired

cached_tokensintegerRequired

roundsintegerRequired

errorany ofOptional

stringOptional

or

nullOptional

401

Missing or invalid API key.

403

Insufficient permissions.

404

Skill not found.

422

Validation Error

application/json

post

/v1/{workspace_id}/skills/{skill_id}/test

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/skills/{skill_id}/test HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "input": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "static_tool_mocks": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

{
  "result": "text",
  "duration_ms": 1,
  "input_tokens": 1,
  "output_tokens": 1,
  "cached_tokens": 1,
  "rounds": 1,
  "sub_tool_logs": [
    {
      "tool_name": "text",
      "input": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "output": "text",
      "duration_ms": 1,
      "succeeded": true,
      "round": 1
    }
  ],
  "error": "text"
}