Skip to content
Open app

oauth.approve

POST /api/v1/oauth/approve. 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/oauthapprove.mdtext/markdown
POST
/api/v1/oauth/approve
Code sample: Shell / cURL
curl --request POST \
--url https://app.intraface.cc/api/v1/oauth/approve \
--header 'Content-Type: application/json' \
--cookie __session=<__session> \
--data '{ "client_id": "example", "redirect_uri": "https://example.com", "code_challenge": "example", "code_challenge_method": "S256", "state": "example", "scope": "example", "resource": "example" }'

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

Media typeapplication/json
object
client_id
required
string
>= 20 characters <= 2000 characters
redirect_uri
required
string format: uri
<= 500 characters
code_challenge
required
string
>= 43 characters <= 128 characters
code_challenge_method
required
string
Allowed value: S256
state
string
<= 500 characters
scope
string
<= 200 characters
resource
string
<= 500 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"
}
}