POST /agent/claim
Bind a formal email to an anonymous trial and send a 6-digit code.
REST API overview · OpenAPI JSON · OpenAPI YAML
| Stability | Authentication | Cost | Operation ID |
|---|---|---|---|
| Published | None | Free | agent_claim_start_api_v1_agent_claim_post |
This operation has no path or query parameters.
Schema: AgentClaimStartRequest
| Name | Required | Type | Description |
|---|---|---|---|
claim_code | Yes | string | — |
email | Yes | string | — |
curl --request POST \
--url "https://qveris.ai/api/v1/agent/claim" \
--header 'Content-Type: application/json' \
--data '{
"claim_code": "claim-code-123456",
"email": "operator@example.com"
}'
const response = await fetch("https://qveris.ai/api/v1/agent/claim", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({
"claim_code": "claim-code-123456",
"email": "operator@example.com"
}),
})
if (!response.ok) throw new Error(`QVeris request failed: ${response.status}`)
console.log(await response.json())
import json
import requests
response = requests.request(
"POST",
"https://qveris.ai/api/v1/agent/claim",
json=json.loads(r'''{
"claim_code": "claim-code-123456",
"email": "operator@example.com"
}'''),
timeout=30,
)
response.raise_for_status()
print(response.json())
| Status | Meaning | Schema |
|---|---|---|
200 | Successful Response | APIResponse_Union_AgentClaimStartResponse__AgentClaimRiskBlockResponse__ |
422 | Validation Error | HTTPValidationError |
429 | Too Many Requests | PublicApiError |
{
"status": "success",
"message": "Verification code sent. Enter it to bind this anonymous trial to the email.",
"status_code": 0,
"data": {
"email": "operator@example.com"
}
}
POST Discover capabilities · POST Inspect capabilities · POST Probe a capability · POST Call a capability
Was this page helpful?