ts.res.update

Update resource attributes (partial update).

Update resource attributes (partial update).

Requires authentication

Description

Updates one or more fields on an existing resource. Only the provided fields are changed; omitted fields retain their current values.

The resource type cannot be changed after creation.

Parameters

NameTypeRequiredDefaultDescription
idstringYesResource ID
namestringNew name
capacity_modelstringCapacity model: hours_per_week, tokens_per_day, always_on, budget
capacity_valuenumberAmount of capacity
skillsarrayList of skills or capabilities (replaces existing)
metadataobjectMetadata to set (replaces existing)
statusstringNew status: active, inactive

Response

Returns the updated resource.

{
  "capacity_model": "always_on",
  "created_at": "2026-02-07T10:00:00Z",
  "id": "res_abc123",
  "metadata": {
    "timezone": "UTC"
  },
  "name": "Senior Build Agent",
  "skills": [
    "go",
    "testing",
    "deployment",
    "monitoring"
  ],
  "status": "active",
  "type": "agent",
  "updated_at": "2026-02-10T14:30:00Z"
}

Errors

CodeDescription
not_authenticatedNo active login for this session
not_foundResource with this ID does not exist
invalid_inputNo fields to update, or invalid status value

Examples

Update resource name and skills

Change a resource’s name and add new skills.

Request:

{
  "id": "res_abc123",
  "name": "Senior Build Agent",
  "skills": [
    "go",
    "testing",
    "deployment",
    "monitoring"
  ]
}

Response:

null

Deactivate a resource

Set a resource to inactive status.

Request:

{
  "id": "res_abc123",
  "status": "inactive"
}

Response:

null