# McpAuthorization


[API catalog](/reference/api/) · [Docker Sandboxes overview](/reference/api/sandboxes/latest/) · [Product manual](https://docs.docker.com/ai/sandboxes-api/) · [OpenAPI specification](/reference/api/sandboxes/api.yaml)

API version: v1


> This API is experimental. Features, interfaces,
> and behavior may change.




Schema constraints and annotations:

```json
{
  "description": "McpAuthorization is the current authorization incarnation for one named upstream.",
  "properties": {
    "authorizationUrl": {
      "description": "authorization_url is present only while interaction is pending.",
      "readOnly": true,
      "type": "string"
    },
    "createdAt": {
      "$ref": "#/components/schemas/Timestamp",
      "readOnly": true
    },
    "etag": {
      "description": "etag identifies this incarnation and changes with every visible authorization update.",
      "readOnly": true,
      "type": "string"
    },
    "expiresAt": {
      "$ref": "#/components/schemas/Timestamp",
      "description": "expires_at bounds the pending flow; expiry records FAILED on this incarnation.",
      "readOnly": true
    },
    "failure": {
      "$ref": "#/components/schemas/Error",
      "readOnly": true
    },
    "name": {
      "description": "(IDENTIFIER) name is the complete singleton resource name.",
      "type": "string"
    },
    "server": {
      "description": "(OPTIONAL) server is the complete resource name, in the form mcp-servers/{server}.",
      "pattern": "^(?:mcp-servers/[^/]+)?$",
      "type": "string"
    },
    "status": {
      "$ref": "#/components/schemas/McpAuthorizationStatus",
      "readOnly": true
    },
    "uid": {
      "description": "(IMMUTABLE) uid is the existing immutable backing identity, omitted when none is available.",
      "readOnly": true,
      "type": [
        "string",
        "null"
      ]
    },
    "updatedAt": {
      "$ref": "#/components/schemas/Timestamp",
      "readOnly": true
    }
  },
  "title": "McpAuthorization",
  "type": "object"
}
```