Register a redirect URI

This method registers a redirect URI on your account’s allow-list. Once registered, the URI can be used as the redirect_uri when starting the authorization flow with the authorize-connection method. The URI must use HTTPS and resolve to a public host.

Authentication

x-api-keystring
Your API key. <Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>

Request

This endpoint expects an object.
redirect_uristringRequired

The redirect URI to register. Must use HTTPS, resolve to a public host, and contain no wildcards. The value is stored exactly as provided and matched byte-for-byte during authorization.

Response

The redirect URI has been successfully registered.
_idstring
The unique identifier of the redirect URI.
redirect_uristring
The registered redirect URI.
created_atstringformat: "date-time"

The date and time, in the RFC 3339 format (“YYYY-MM-DDTHH:mm:ssZ”), when the redirect URI was registered.

Errors

400
Bad Request Error
409
Conflict Error
422
Unprocessable Entity Error