Cowdidocs
API ReferenceProfile

Get the caller's configuration

GET
/v1/user/configurations

Returns the caller's configuration settings. Today this is only the PIN-reset requirement an administrator can set on the caller's account. A user token calls this on behalf of the signed-in user.

Authorization

oauth2
AuthorizationBearer <token>

Create a client with POST /v1/oauth/clients, then exchange its credentials for an access token. AUTHORIZATION_CODE clients act on behalf of a signed-in user and always use PKCE; CLIENT_CREDENTIALS clients act as themselves. A client may only be granted scopes its creator already holds — read the grantable list from GET /v1/oauth/clients/scopes.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/user/configurations"
{  "require_pin_reset": true,  "require_pin_reset_at": "2025-11-20T14:30:00Z"}
{  "code": "BAD_REQUEST",  "description": "Bad Request"}
{  "code": "UNAUTHORISED",  "description": "Unauthorised"}
{  "code": "FORBIDDEN",  "description": "Forbidden"}
{  "code": "RATE_LIMIT_EXCEEDED",  "description": "Too Many Requests"}
{  "code": "INTERNAL_ERROR",  "description": "Internal Server Error"}

Set the caller's avatar PUT

Sets the caller's avatar customisation, or clears it when `options` is null. The value is an opaque query string the client appends to its avatar style URL. A user token calls this on behalf of the signed-in user. Returns the caller's updated user record.

Get the caller's profile settings GET

Returns the caller's global profile: the name, locale, and timezone shared across every organization the caller belongs to. A user token calls this on behalf of the signed-in user. Returns 404 when the caller has no profile yet.