---
title: "Add Collaborator"
method: POST
path: "/claims/{claim_id}/collaborators"
tags: ["claims"]
---

# Add Collaborator

`POST /claims/{claim_id}/collaborators`

## Request

- Base URL: `https://api.claimkit.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.claimkit.co/claims/{claim_id}/collaborators`
- Auth: none declared

Invite a user to the claim's workspace or to this claim only.

The invite records a ``ClaimInvitation`` carrying ``body.scope``;
acceptance is what creates the access row — a ``WorkspaceMember`` for
``scope='workspace'`` (pre-CARP-349 behaviour, still the default) or a
``ClaimCollaborator`` for ``scope='claim'``. ``body.tracking_only``
(claim scope only) makes that collaborator tracking-only.

Owner-gated: only the claim creator can invite.

## Path parameters

- `claim_id` integer, required

## Request body

- AddCollaboratorRequest
  - `email` string, email, required
  - `scope` 'workspace' | 'claim'
  - `tracking_only` boolean

## Response `200`

Successful Response

- CollaboratorsListResponse
  - `collaborators` CollaboratorResponse[], required
    - `user_id` integer, required
    - `email` string, required
    - `name` string, nullable
    - `added_by_name` string, nullable
    - `created_at` string, required
    - `scope` 'workspace' | 'claim'
    - `tracking_only` boolean
  - `invitations` InvitationResponse[], required
    - `id` integer, required
    - `email` string, required
    - `status` string, required
    - `invited_by_name` string, nullable
    - `created_at` string, required
    - `expires_at` string, required
    - `scope` 'workspace' | 'claim'
    - `tracking_only` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimkit/apis/claimkit-api.md) - [All operations](https://skmtc.dev/claimkit/apis/claimkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/claimkit/apis/claimkit-api/revisions/94dc85ba5326?raw)