{
  "$defs": {
    "BudgetPeriod": {
      "description": "Window of a per-token vCPU-second budget (UTC calendar day or month).",
      "enum": [
        "day",
        "month"
      ],
      "title": "BudgetPeriod",
      "type": "string"
    },
    "TokenStatus": {
      "enum": [
        "active",
        "expired",
        "revoked"
      ],
      "title": "TokenStatus",
      "type": "string"
    }
  },
  "$id": "https://schemas.mapi.dev/v1/api-ApiToken.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "A token as listed by the API. It never carries the secret or its hash.",
  "examples": [
    {
      "budget_period": "month",
      "created_at": "2026-10-15T09:30:00Z",
      "display": "mapi_7k2m9q4x_\u2026",
      "expires_at": "2026-11-14T09:30:00Z",
      "id": "tok_01jaf3r1s2t3v4w5x6y7z8a9b0",
      "last_used_at": "2026-10-16T08:00:00Z",
      "name": "budget-planner",
      "owner_id": "usr_01jaf3a9b8c7d6e5f4g3h2j1k0",
      "prefix": "7k2m9q4x",
      "project_id": "growth",
      "rate_limit_per_minute": 120,
      "scopes": [
        "score:geo-mmm-prod",
        "models:read"
      ],
      "status": "active",
      "tenant_id": "acme",
      "vcpu_seconds_budget": 36000
    }
  ],
  "properties": {
    "budget_period": {
      "$ref": "#/$defs/BudgetPeriod",
      "default": "month"
    },
    "created_at": {
      "format": "date-time",
      "title": "Created At",
      "type": "string"
    },
    "display": {
      "description": "Redacted form, mapi_<prefix>_\u2026",
      "title": "Display",
      "type": "string"
    },
    "expires_at": {
      "format": "date-time",
      "title": "Expires At",
      "type": "string"
    },
    "id": {
      "examples": [
        "run_01jaf3q2x8m9v7k5h4g3f2e1d0"
      ],
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.\\-]{0,127}$",
      "title": "Id",
      "type": "string"
    },
    "last_used_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Last Used At"
    },
    "name": {
      "title": "Name",
      "type": "string"
    },
    "owner_id": {
      "description": "Principal id of the user or service that minted it",
      "examples": [
        "run_01jaf3q2x8m9v7k5h4g3f2e1d0"
      ],
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.\\-]{0,127}$",
      "title": "Owner Id",
      "type": "string"
    },
    "prefix": {
      "examples": [
        "7k2m9q4x"
      ],
      "pattern": "^[0123456789abcdefghjkmnpqrstvwxyz]{8}$",
      "title": "Prefix",
      "type": "string"
    },
    "project_id": {
      "pattern": "^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$",
      "title": "Project Id",
      "type": "string"
    },
    "rate_limit_per_minute": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Rate Limit Per Minute"
    },
    "revoked_at": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Revoked At"
    },
    "scopes": {
      "items": {
        "examples": [
          "models:read",
          "runs:create",
          "score:geo-mmm-prod"
        ],
        "maxLength": 140,
        "type": "string"
      },
      "title": "Scopes",
      "type": "array"
    },
    "status": {
      "$ref": "#/$defs/TokenStatus"
    },
    "tenant_id": {
      "pattern": "^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$",
      "title": "Tenant Id",
      "type": "string"
    },
    "vcpu_seconds_budget": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Vcpu Seconds Budget"
    }
  },
  "required": [
    "id",
    "tenant_id",
    "project_id",
    "owner_id",
    "name",
    "prefix",
    "display",
    "scopes",
    "status",
    "created_at",
    "expires_at"
  ],
  "title": "ApiToken",
  "type": "object",
  "x-mapi-contract-version": "0.2"
}