Skip to content

Get a skill's manifest (slot schemas)

GET /skills/{skill_id}/manifest

https://api.voygr.tech/skills/{skill_id}/manifest

Open in playground

Overview

Machine-readable contract for a skill: input_schema (JSON Schema for its slots), intent_types_supported, event_types, ask_user_modes_supported, URL templates and limits. The 422 missing_slots hints on POST /calls point here - fetch it once and drive slot collection from it.

Authentication

  • API key in header X-API-Key: Your customer API key (pk_live_...), sent on every request. Self-serve at https://api.voygr.tech/checkout.

Parameters

NameLocationRequiredTypeDescription and constraints
skill_idpathrequiredstring

Example 1

"concierge"

Responses

200

Successful Response

application/json

Schema: object

Keys include: skill_id, title, description, version, input_schema, intent_types_supported, event_types, ask_user_modes_supported, run/status/answer/events URL templates, limits.

401

Missing or invalid X-API-Key.

application/json

X-API-Key header absent

{
  "detail": {
    "error": "API key required"
  }
}

X-API-Key doesn't resolve to an active key

{
  "detail": {
    "error": "invalid API key"
  }
}

404

Unknown skill_id.

application/json

notfound

{
  "detail": "Skill not found"
}