Files

Claim an anonymous file into your account

Attaches the anonymous file a claimToken references (returned by anonymous uploads, Canva publishes, and the Canva design status endpoint) to the authenticated bearer user's account. The programmatic twin of the /api/claim browser link: use it when the claiming identity must be EXACTLY the connected account - e.g. the Canva panel claims into the account its OAuth grant belongs to in the same gesture as connecting. The file keeps its expiry and encryption key; claiming unlocks the owner surfaces (library, readership, settings). Idempotent for the same owner: re-claiming a file you already own returns 200. Scope files:write.

post/api/v1/files/claim

Request

  • Base URL: https://everypage.co
  • URL: https://everypage.co/api/v1/files/claim
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://everypage.co/oauth/authorize, token URL https://everypage.co/oauth/token, scopes: files:write)

Request body

claimTokenstring required

The claim token bound to the file (30-day validity).

Response

Claimed (or already yours)

uuidstring uuid
shortIdstring
viewURLstring

Example response

{
  "shortId": "aB3xY9kQ2mZ7",
  "viewURL": "https://everypage.co/aB3xY9kQ2mZ7"
}

Changes

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