Register an app (V0)

POST

/api/admin/protocol/apps

• Protocol hub (Next.js) — federation, writes, receipts, market context

Admin-only registration. confidential: true mints a client secret shown once (stored hashed). Financial scopes cannot be registered.

Authorizations

• adminSecret

Request Body ^required

object

slug

required

string

name

required

string

description

string

redirectUris

required

Array<string>

allowedOrigins

Array<string>

allowedScopes

Array<string>

confidential

boolean

developerUserId

string

Responses

201

App + clientSecret (once)

400

invalid_request / invalid_scope / invalid_grant

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

401

unauthenticated

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

409

Slug taken

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any