Skip to content
Open app

cli.authorize

POST /api/v1/cli/authorize. A signed-in person (Clerk session cookie). Agent tokens are refused. Body limit: 256 KB.

CLI 0.4.0 · MCP · API v1View as Markdown
GET /docs/reference/api/operations/cliauthorize.mdtext/markdown
POST
/api/v1/cli/authorize
Code sample: Shell / cURL
curl --request POST \
--url https://app.intraface.cc/api/v1/cli/authorize \
--header 'Content-Type: application/json' \
--cookie __session=<__session> \
--data '{ "state": "example", "code_challenge": "example", "code_challenge_method": "S256", "redirect_port": 1, "label": "example", "agent": "example" }'

A signed-in person (Clerk session cookie). Agent tokens are refused. Body limit: 256 KB.

Media typeapplication/json
object
state
required
string
>= 16 characters <= 128 characters
code_challenge
required
string
>= 43 characters <= 128 characters
code_challenge_method
required
string
Allowed value: S256
redirect_port
required
integer
>= 1024 <= 65535
label
required
string
>= 1 characters <= 80 characters
agent
string
<= 64 characters

Success.

Media typeapplication/json
object
redirect_url
required
string format: uri

Example generated

{
"redirect_url": "https://example.com"
}

Any error: see error.code.

Media typeapplication/json
object
error
required
object
code
required

A stable error code: see the error codes table in the API overview.

string
message
required
string
hint
string
details

Example generated

{
"error": {
"code": "example",
"message": "example",
"hint": "example",
"details": "example"
}
}