API Keys

Create an OpenAPI key

post/api/v1/api-keys

Request body

namestring required
scopesstring[]
expires_atstring date-time
expires_in_daysinteger

Example request

{
  "scopes": [
    "bot",
    "provider",
    "persona",
    "im",
    "config",
    "chat",
    "plugin",
    "mcp",
    "skill"
  ]
}

Response

Standard AstrBot success response

status'ok' required
messagestring
{"stackTrail":"components:schemas:SuccessEnvelope:properties:data","oasType":"schema","type":"unknown"}

Changes