PRprimitive
Organization settings

Replace the organization logo

Upload a PNG, JPEG, GIF or WebP logo of at most 900 KB, base64 encoded.

Person only: a dashboard session, or the person's own OAuth token with a step-up token for purpose org_settings.write in the Primitive-Step-Up header. Without one an OAuth token is answered 403 step_up_required, whose details carry the dashboard URL that issues it (or 403 grant_forbidden when the person's role could not do it anyway). The person's role must hold org:manage (or members:manage). API keys and agent connection keys are refused. An agent acting for the person is refused unless it carries a step-up token the person issued in the dashboard.

put/organization/logo

Request

  • Base URL
    https://api.primitive.dev/v1
  • URL
    https://api.primitive.dev/v1/organization/logo
  • Auth
    HTTP bearer

Headers

Primitive-Step-Upstring

A single-use step-up token the person issued in the dashboard for this operation's purpose (valid five minutes). Needed only when calling with an OAuth token; a dashboard session does not send it. Accepted only with a token of the client it was confirmed for; refused with a token issued for MCP and with any API key.

Request body

content_type'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' required
data_base64string required

Response

Success

successtrue required

Changes

No operation changes recorded.