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": "editors_and_owners",
6     "is_deleted": false,
7     "created": "2026-07-20T14:32:00Z",
8     "modified": "2026-07-20T14:32:00Z",
9     "active_revision": {
10       "id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
11       "task_agent_id": "019df849-e117-2017-a34d-e056c24d33f7",
12       "created": "2026-07-20T14:32:00Z",
13       "modified": "2026-07-20T14:32:00Z"
14     },
15     "revisions": [
16       {
17         "id": "019df849-e12a-b57e-62d4-0e5875e91ef4",
18         "task_agent_id": "019df849-e117-2017-a34d-e056c24d33f7",
19         "description": "Handles support triage and draft responses.",
20         "instruction": "Triage the customer request and draft a concise response.",
21         "mode": "agentic",
22         "llm_model_id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
23         "fallback_llm_model_id": "af2a9bbf-5f36-4b12-bd3f-92c57be96dec",
24         "created": "2026-07-20T14:32:00Z",
25         "llm_model": {
26           "provider": "OpenAI",
27           "vendor": "openai",
28           "name": "gpt-4-turbo",
29           "alias": "GPT-4 Turbo",
30           "description": "Latest GPT-4 Turbo model with vision capabilities. 128K context window with training cut off of Dec 2023.",
31           "supports_vision": true,
32           "max_context_window": 128000,
33           "id": "ec217e75-72ea-4281-a1b8-cb7bd0ef9f41",
34           "supports_image_output": false,
35           "supports_pdf_vision": false,
36           "supports_tool_calling": true,
37           "supports_context_caching": false,
38           "price": "average",
39           "speed": "fast",
40           "knowledge_cutoff": "2023-12-01",
41           "created": "2024-01-16T13:33:25.247662Z",
42           "modified": "2024-01-16T13:33:25.247662Z"
43         },
44         "fallback_llm_model": {
45           "provider": "OpenAI",
46           "vendor": "openai",
47           "name": "gpt-3.5-turbo",
48           "alias": "GPT-3.5 Turbo",
49           "description": "Fast, efficient model suitable for simple tasks. 16K context window.",
50           "supports_vision": false,
51           "max_context_window": 16385,
52           "id": "af2a9bbf-5f36-4b12-bd3f-92c57be96dec",
53           "supports_image_output": false,
54           "supports_pdf_vision": false,
55           "supports_tool_calling": true,
56           "supports_context_caching": false,
57           "price": "cheap",
58           "speed": "standard",
59           "knowledge_cutoff": "2021-09-01",
60           "created": "2024-01-16T13:33:25.247662Z",
61           "modified": "2024-01-16T13:33:25.247662Z"
62         },
63         "task_tools": [
64           {
65             "id": "019df849-e12a-b57e-62d4-0e5875e91ef7",
66             "task_id": "019df849-e12a-b57e-62d4-0e5875e91ef8",
67             "task_name": "Customer Support Analyzer",
68             "order": 0,
69             "enabled": true,
70             "task_revision_id": "019df849-e12a-b57e-62d4-0e5875e91ef9",
71             "revision_strategy": "pinned",
72             "is_output_formatter": true,
73             "action_mode": "auto_run",
74             "rejection_behavior": "end_run"
75           }
76         ],
77         "integrations": [],
78         "skills": [],
79         "mcp_servers": [],
80         "registered_tools": [],
81         "tags": [],
82         "active": true,
83         "modified": "2026-07-20T14:32:00Z"
84       }
85     ],
86     "shared_with_project": false
87   },
88   "runnable": false,
89   "dependency_report": [
90     {
91       "kind": "integration",
92       "action": "cloned",
93       "status": "setup_required",
94       "source_id": "019df849-e12a-b57e-62d4-0e5875e91ef5",
95       "target_id": "019df849-e12a-b57e-62d4-0e5875e91ef6",
96       "name": "google_sheets",
97       "reason": "integration_auth_required",
98       "message": "Integration metadata was copied without credentials and requires reauthorization."
99     },
100     {
101       "kind": "registered_tool",
102       "action": "reused",
103       "status": "ready",
104       "name": "rfp-response-analyzer"
105     }
106   ]
107 }

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

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

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 objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

422

Unprocessable Entity Error