---
title: "Accept a project transfer"
method: POST
path: "/v1/projects/{project_id}/transfer/accept"
tags: ["Projects"]
---

# Accept a project transfer

`POST /v1/projects/{project_id}/transfer/accept`

## Request

- Base URL: `https://api.naturali.ai`
- URL: `https://api.naturali.ai/v1/projects/{project_id}/transfer/accept`
- Auth: HTTP bearer

Makes the caller — the member the transfer names — the project's owner.

Usage up to this moment is settled on the previous owner's credit; from here on the project's usage is billed to the caller, and its runs count against the caller's allowance. The project counts toward the caller's plan limits at once: its active channels and triggers, and on Free the project itself. A transfer the caller's plan cannot hold is refused with `403 plan_limit_reached`, and the project's retention window is brought within the caller's plan.

The previous owner stays in the project as an `admin`. Stops recorded against the project's spend move to the caller. Refused to a connected app.

## Response `200`

The completed transfer.

- ProjectTransfer: A change of the project's owner, pending or completed.
  - `project_id` string, required
  - `status` 'pending' | 'completed', required
  - `from_user_id` string, required: The owner before the transfer.
  - `to_user_id` string, required: The owner after it.
  - `requested_at` string, date-time, nullable, required
  - `transferred_at` string, date-time, nullable, required: When ownership moved; `null` while pending.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: The caller's plan cannot hold the project (`plan_limit_reached`), a project-scoped credential, or a connected app.
- `404`: No such project, or no transfer to the caller is pending.
- `409`: The transfer was withdrawn or changed while it was being accepted (`transfer_changed`).
- `502`: The project's usage could not be read to settle it before the transfer (`upstream_unavailable`); nothing was transferred.

---

[API](https://skmtc.dev/naturali/apis/naturali-ai-api.md) · [All operations](https://skmtc.dev/naturali/apis/naturali-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/naturali/apis/naturali-ai-api/revisions/e4905b78f422?raw)