SHshareout
Workspaces

Mint a workspace Agent token

Mints a non-human, workspace-scoped Agent token (prefix sot_). Creates a headless service principal and adds it as a first-class workspace member that owns the artifacts it publishes. Plaintext token is returned exactly once. Owner/admin only.

post/v1/workspaces/{workspaceId}/agent-tokens

Request

  • Base URL
    https://shareout.site
  • URL
    https://shareout.site/v1/workspaces/{workspaceId}/agent-tokens
  • Auth
    HTTP bearer

Request body

namestring required

Human label, e.g. "CI bot".

scopesstring[] required
expires_atstring nullable

Optional ISO datetime; omit for no expiry.

Response

Token minted (plaintext shown once)

okboolean
tokenstring
shown_onceboolean
token_idstring
principal_user_idstring
scopesstring[]

Example response

{
  "token": "sot_…"
}

Changes

No recorded changes to this operation across all 22 revisions of this API.