Auth

Create an API token

post/api-tokens

Request

  • Base URL: https://app.openpo.st/api/v1
  • URL: https://app.openpo.st/api/v1/api-tokens
  • Auth: one of:
    • HTTP bearer
    • API key in cookie openpost_session

Request body

$schemastring uri

A URL to the JSON Schema for this object.

expires_atstring date-time nullable

Expiry time. Omitted or null defaults to 90 days; the maximum lifetime is one year.

namestring required

Required user-visible token name

scope'cli:full' | 'mcp:read' | 'mcp:full' | 'api:read' | 'api:write'

Token scope. Defaults to cli:full.

workspace_idstring

Optional workspace ID this token is limited to

Example request

{
  "$schema": "https://example.com/api/v1/schemas/CreateAPITokenInputBody.json"
}

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

tokenstring required

Raw API token. Returned once and never stored in plaintext.

Example response

{
  "$schema": "https://example.com/api/v1/schemas/CreateAPITokenOutputBody.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.