v1

latestOpenAPI 3.1.0Any Source Available License 1.02026-07-1736102200.0 KB

Auth

Create Challenge

Generates a one-time authentication challenge for granting API access to the user's vault. Upon providing a valid app_name, the server issues a unique challenge_id and displays a 4-digit code within the Anytype Desktop. The challenge_id must then be used with the /v1/auth/api_keys endpoint to solve the challenge and retrieve an authentication token. This mechanism ensures that only trusted applications and authorized users gain access.

post/v1/auth/challenges

Headers

Anytype-Versionstring required

The version of the API to use

Request body

app_namestring

The name of the app that is requesting the challenge

Example request

{
  "app_name": "anytype_mcp"
}

Response

The challenge ID associated with the started challenge

challenge_idstring

The challenge id associated with the displayed code and needed to solve the challenge for api_key

Example response

{
  "challenge_id": "67647f5ecda913e9a2e11b26"
}