Tokens

curl https://api.animam.ai/tenants/my-company/tokens \
  -H "Authorization: Bearer ak_your_token"

{
  "tokens": [
    {
      "id": "3f8a1c2e-9d4b-4e6a-8f21-7c0d5b9e1a34",
      "name": "Production API",
      "description": null,
      "scopes": ["corpus:read", "corpus:write"],
      "createdAt": "2024-01-15T10:30:00Z",
      "lastUsedAt": "2024-01-25T14:22:00Z",
      "usageCount": 128,
      "expiresAt": null,
      "isActive": true
    },
    {
      "id": "a1b2c3d4-5e6f-4a7b-9c8d-0e1f2a3b4c5d",
      "name": "Analytics readonly",
      "description": null,
      "scopes": ["conversations:read"],
      "createdAt": "2024-01-20T08:00:00Z",
      "lastUsedAt": null,
      "usageCount": 0,
      "expiresAt": "2024-12-31T23:59:59Z",
      "isActive": true
    }
  ],
  "availableScopes": ["segments:read", "segments:write", "corpus:read", "corpus:write", "tools:read", "tools:write", "visitors:read", "visitors:write", "conversations:read", "conversations:write", "settings:read", "settings:write", "billing:read", "stats:read"]
}

curl -X POST https://api.animam.ai/tenants/my-company/tokens \
  -H "Authorization: Bearer ak_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "CI/CD Pipeline",
    "scopes": ["corpus:read", "corpus:write"],
    "expiresAt": "2025-01-01T00:00:00Z"
  }'

{
  "id": "9c8d7e6f-5a4b-4c3d-2e1f-0a9b8c7d6e5f",
  "name": "CI/CD Pipeline",
  "token": "ak_your_generated_token...",
  "scopes": ["corpus:read", "corpus:write"],
  "createdAt": "2024-01-25T10:30:00Z",
  "expiresAt": "2025-01-01T00:00:00Z",
  "message": "Token created. Save it now - it will not be shown again!"
}

curl -X DELETE https://api.animam.ai/tenants/my-company/tokens/3f8a1c2e-9d4b-4e6a-8f21-7c0d5b9e1a34 \
  -H "Authorization: Bearer ak_your_token"

{
  "success": true,
  "message": "Token deleted"
}

// Bad: too many permissions
{ "scopes": ["*"] }

// Good: minimal permissions
{ "scopes": ["corpus:read"] }

{
  "name": "Temporary test token",
  "scopes": ["corpus:read"],
  "expiresAt": "2024-02-01T00:00:00Z"
}