Replace task set
const url = 'https://example.com/api/v1/org/example/task-sets/example';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"description":"example","members":[{"notes":"example","task_name":"example","task_version":"example"}],"source":"example","tags":["example"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://example.com/api/v1/org/example/task-sets/example \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "description": "example", "members": [ { "notes": "example", "task_name": "example", "task_version": "example" } ], "source": "example", "tags": [ "example" ] }'Replace the manifest of an existing task set (TSS-MUT-001)
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Task set name
Task set name
Organization slug
Organization slug
Request Body required
Section titled “Request Body required ”Request body for PUT /task-sets/{name} — full replace (TSS-MUT-001).
Visibility is deliberately NOT part of this body. A full-replace PUT must
never flip publish state — that is owned solely by
PATCH /task-sets/{name}/visibility (TSS-MUT / TSS-VIS-002). extra="ignore"
means a client that still sends is_public is silently tolerated but the
value is never honored.
object
Task references
One entry in TaskSetORM.members JSONB column.
Both the manifest and the API accept the string form name or
name@version; the API also accepts the object form. The model is the
canonical object form — string inputs are coerced upstream in
:func:coerce_member.
task_version is optional. None (bare reference) resolves to the
latest task version visible to the caller at use time. A pinned reference
must be fixed semver per TSS-MANI-005.
Example generated
{ "description": "example", "members": [ { "notes": "example", "task_name": "example", "task_version": "example" } ], "source": "example", "tags": [ "example" ]}Responses
Section titled “ Responses ”Successful Response
Full task set detail returned by GET /task-sets/{name}.
object
Small denormalized user identity for cross-domain byline display.
A member as the API returns it on read.
Bare references are resolved at read time under the caller’s visibility. Unresolvable members are surfaced rather than hidden.
object
Number of members that cannot resolve under the caller now
Example
{ "members": [ { "unresolvable_reason": "not_found" } ]}Invalid request
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Authentication failed
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Access forbidden
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Not found
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Already exists
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Validation error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Upgrade required
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Rate limited
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Internal server error
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Bad gateway
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}Gateway timeout
Canonical API error envelope returned by the API.
object
HTTP status code
Human-readable error message
object
Where the validation error occurred
Human-readable validation message
Machine-readable validation error type
Stable machine-readable error type
Example
{ "code": 401, "detail": "Authentication failed", "type": "authentication_error"}