Clone Shared TaskAgent

POST

/org/:org_id/project/:project_id/task-agent/clone/:short_id

POST

/api/v1/org/:org_id/project/:project_id/task-agent/clone/:short_id

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task-agent/clone/short_id \
>      -H "Authorization: Bearer <token>"

1 {
2   "task_agent": {
3     "id": "019df849-e117-2017-a34d-e056c24d33f7",
4     "name": "Support Agent copy",
5     "task_agent_run_visibility": "owner_only",
6     "is_deleted": true,
7     "created": "string",
8     "modified": "string",
9     "active_revision": {
10       "id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
11       "task_agent_id": "string",
12       "created": "string"
13     },
14     "revisions": [],
15     "project_id": "0190a234-9876-5432-10ab-cdef01234567",
16     "description": "Handles support triage and draft responses.",
17     "instruction": "Triage the customer request and draft a concise response.",
18     "mode": "agentic"
19   },
20   "runnable": false,
21   "dependency_report": [
22     {
23       "kind": "integration",
24       "action": "cloned",
25       "status": "setup_required",
26       "source_id": "019df849-e12a-b57e-62d4-0e5875e91ef5",
27       "target_id": "019df849-e12a-b57e-62d4-0e5875e91ef6",
28       "name": "google_sheets",
29       "reason": "integration_auth_required",
30       "message": "Integration metadata was copied without credentials and requires reauthorization."
31     },
32     {
33       "kind": "registered_tool",
34       "action": "reused",
35       "status": "ready",
36       "name": "rfp-response-analyzer"
37     }
38   ]
39 }

Clone a shared TaskAgent revision into the target project.

Requires project:create_task_agent on the target project. The clone path commits new database rows before writing IAM relationships, never copies source IAM relationships, and conditionally checks dependency-specific create permissions before cloning Tasks, Skills, integrations, or MCP servers.

The response includes a dependency report. runnable=false means at least one dependency requires setup, such as reauthorizing a copied integration or MCP server. MCP-backed Task-tool revisions are cloned by reusing compatible target-project MCP server/tool metadata or copying non-secret metadata. MCP credentials and auth_config are never copied. Auth-required Task-tool MCP dependencies may clone successfully with runnable=false and setup-required dependency report entries.

Clone a shared TaskAgent revision into the target project. Requires `project:create_task_agent` on the target project. The clone path commits new database rows before writing IAM relationships, never copies source IAM relationships, and conditionally checks dependency-specific create permissions before cloning Tasks, Skills, integrations, or MCP servers. The response includes a dependency report. `runnable=false` means at least one dependency requires setup, such as reauthorizing a copied integration or MCP server. MCP-backed Task-tool revisions are cloned by reusing compatible target-project MCP server/tool metadata or copying non-secret metadata. MCP credentials and auth_config are never copied. Auth-required Task-tool MCP dependencies may clone successfully with `runnable=false` and setup-required dependency report entries.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

short_idstringRequired

TaskAgent share short ID

org_idstringRequiredformat: "uuid"

The organization ID

project_idstringRequiredformat: "uuid"

The project ID

Response

TaskAgent share cloned

task_agentobject

Schema for reading a TaskAgent.

runnableboolean

dependency_reportlist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

422

Unprocessable Entity Error