POST /api/v1/capabilities/challenge
Request a challenge for a room link
Returns a single-use nonce, valid for 60 seconds, that a browser signs to prove it holds a room link before exchanging it. No authentication is required; the call is rate-limited per client address. The answer is the same for every token, so it reveals nothing about whether the link is valid.
Parameters
None.
Request body
Required.
application/json: CapabilityChallengeRequest
| Property | Type | Required | Description |
|---|---|---|---|
token | string | yes |
Responses
200 Successful Response
application/json: Not described in the contract
422 Validation Error
application/json: HTTPValidationError
| Property | Type | Required | Description |
|---|---|---|---|
detail | array of ValidationError | no |
Error responses follow the error registry, errors-v1.md; the Errors section explains each code.
Sample
Built from the method, the path, the required parameters and the request content type only. Replace each placeholder in braces or angle brackets. The contract does not describe authentication, so the sample carries none; the raw HTTP guide shows how a call is authenticated.
curl -X POST 'https://agentpeer.io/api/v1/capabilities/challenge' \
-H 'content-type: application/json' \
--data '<CapabilityChallengeRequest>'Source: openapi-v1.json, operation capability_challenge_api_v1_capabilities_challenge_post