---
updatedAt: 2026-04-21T13:00:26.000Z
agentTools:
  projectIndex: https://docs.sivo.com/llms.txt
---

# Retrieve an authorize

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Sivo Advance API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://core.sivo.com"
    }
  ],
  "security": [
    {
      "APIKeyAuth": []
    },
    {
      "OAuth2": []
    }
  ],
  "components": {
    "securitySchemes": {
      "APIKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization"
      },
      "OAuth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://core.sivo.com/oauth/token",
            "scopes": {}
          },
          "authorizationCode": {
            "authorizationUrl": "https://dashboard.sivo.com/oauth/authorize",
            "tokenUrl": "https://core.sivo.com/oauth/token",
            "refreshUrl": "https://core.sivo.com/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "paths": {
    "/oauth/authorize/{id}": {
      "get": {
        "summary": "Retrieve an authorize",
        "tags": [
          "API authentication"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^[a-z]{3,7}_[0-9A-Za-z]{27}$",
              "description": "An object id with prefix",
              "example": "user_0123456789ABCDEFGHIJKLMNOPq"
            },
            "required": true,
            "description": "An object id with prefix",
            "name": "id",
            "in": "path"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "response_type": {
                      "type": "string",
                      "enum": [
                        "code"
                      ]
                    },
                    "client_id": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Non-empty text string"
                    },
                    "redirect_uri": {
                      "type": "string",
                      "format": "uri",
                      "description": "HTTP(S) URL",
                      "example": "https://www.acme.com"
                    },
                    "state": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Non-empty text string"
                    },
                    "scope": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "email",
                          "openid",
                          "private_metadata",
                          "profile",
                          "public_metadata",
                          "claudeai"
                        ]
                      }
                    },
                    "code_challenge": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Non-empty text string"
                    },
                    "code_challenge_method": {
                      "type": "string",
                      "enum": [
                        "plain",
                        "S256"
                      ]
                    },
                    "prompt": {
                      "type": "string",
                      "enum": [
                        "none",
                        "login",
                        "consent",
                        "select_account"
                      ]
                    },
                    "audience": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Non-empty text string"
                    },
                    "access_type": {
                      "type": "string",
                      "enum": [
                        "online",
                        "offline"
                      ]
                    },
                    "resource": {
                      "type": "string",
                      "format": "uri",
                      "description": "HTTP(S) URL",
                      "example": "https://www.acme.com"
                    },
                    "id": {
                      "type": "string",
                      "pattern": "^[a-z]{3,7}_[0-9A-Za-z]{27}$",
                      "description": "An object id with prefix",
                      "example": "user_0123456789ABCDEFGHIJKLMNOPq"
                    },
                    "created_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Creation date and time",
                      "example": "2024-01-15T10:30:00Z"
                    },
                    "created_by": {
                      "type": "string",
                      "pattern": "^[0-9A-Za-z_-]{1,255}$",
                      "description": "ID of the user that created this object",
                      "example": "user_0123456789ABCDEFGHIJKLMNOPq"
                    },
                    "updated_at": {
                      "type": "string",
                      "format": "date-time",
                      "description": "Last update date and time",
                      "example": "2024-01-15T10:30:00Z"
                    },
                    "updated_by": {
                      "type": "string",
                      "pattern": "^[0-9A-Za-z_-]{1,255}$",
                      "description": "ID of the user that last updated this object",
                      "example": "user_0123456789ABCDEFGHIJKLMNOPq"
                    }
                  },
                  "required": [
                    "response_type",
                    "client_id",
                    "redirect_uri",
                    "id",
                    "created_at",
                    "created_by",
                    "updated_at",
                    "updated_by"
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}
```