POST/api/apps/{app_id}/callback-urlsAuthenticated

Add a callback URL to an app

Registers an explicit callback URL for a client application in one environment. Once at least one callback URL exists for an app + environment, redirect_uri validation for that environment requires an exact match against the registered list (instead of any path on a registered domain). Requires management access; hardcoded apps cannot be configured. The body's app_id must match the path.

operationId post_api_apps_app_id_callback_urlsClient applications

Authentication & permissionsAuthenticated

Any authenticated user

Accepted credentials
Who may call
Any authenticated user

Path parameters

NameTypeDescription
app_id*string

Client application id

Request body

Required

application/json
SchemaVaultsAppCallbackUrlRef
PropertyTypeDescription
app_callback_url_ref_id*string (uuid)
app_id*string

minLength: 2maxLength: 64pattern: ^[a-z0-9_-]*$

callback_url*string (uri)

maxLength: 2048

environment*"development" | "staging" | "test" | "production"
created_at*number

minimum: 0

JSONExample
"app_callback_url_ref_id""123e4567-e89b-12d3-a456-426614174000"
"app_id""string"
"callback_url""https://example.com"
"environment""development"
"created_at"1.5

Responses

application/json
ResourceCreationResponse
PropertyTypeDescription
success*true
message*string
resource_id*string

Identifier of the created / affected resource

JSONExample
"success"true
"message""string"
"resource_id""string"

Example request

bashcurl
curl -X POST 'https://auth.schemavaults.com/api/apps/<app_id>/callback-urls' \
  -b 'refresh_token_<auth_server_app_id>=<value>' \
  -H 'Content-Type: application/json' \
  -d '{
  "app_callback_url_ref_id": "123e4567-e89b-12d3-a456-426614174000",
  "app_id": "string",
  "callback_url": "https://example.com",
  "environment": "development",
  "created_at": 1.5
}'

Other methods on this path

POST /api/apps/{app_id}/callback-urls | SchemaVaults Auth API