---
title: "Claim agent accounts"
method: POST
path: "/credits/agent/claims/accept"
tags: ["Agent-native onboarding"]
---

# Claim agent accounts

`POST /credits/agent/claims/accept`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/agent/claims/accept`
- Auth: none required

Makes the address's owner an owner of each selected pending agent workspace for it (workspaceIds from preview). Other agents may have named the same address, so unselected workspaces stay pending. A new person receives a one-time passwordSetupToken for the set-password screen; an existing account is only added as an owner and signs in as usual.

## Request body

- AgentClaimDecisionRequest
  - `token` string, required: Read from the claim email URL fragment; never sent in a URL.
  - `workspaceIds` string[], required: The workspaces from preview that the person chose.

## Response `200`

Workspaces claimed

## Other responses

- `400`: No workspace selected (CLAIM_SELECTION_REQUIRED)
- `404`: Unknown claim link
- `409`: A selected workspace is no longer pending (CLAIM_SELECTION_STALE)
- `410`: Claim link expired, already claimed, or declined

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)