Publishing

Claim a space with its key

Moves an anonymously published Space into a team of the signed-in user, or returns the one decision still needed: sign-in, team choice, or agent consent. Send the Space key saved by the client that published it, plus any team or consent the user chose, and repeat until the response is claimed. A claimed Space no longer expires. The server checks eligibility. Never ask the user to paste a Space key into chat.

post/v1/claim

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/claim
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

keystring

The space key, when not sent as bearer auth. Browser claim pages send it here after reading the /claim#<key> fragment.

teamIdstring

Team receiving the space. Inferred when the caller has exactly one writable team; otherwise the response answers team_required with the choices.

agentContinuationboolean

User consent to keep the publishing agent authorized after the claim. Required (true or false) when the space is continuation-eligible; the server independently proves eligibility, so consent cannot grant continuation to an ineligible space.

Response

Response for status 200

$schemastring uri

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

Changes

No recorded changes to this operation across all 1 revision of this API.