tasks_update

Melso Agents is available only internally or by private invitation. Agents-specific features require existing access. For the autónomo fiscal service, see Get started.

Edit title, optional summary, or lifecycle. Does not edit messages or start execution. Use tasks_send for new instructions. Availability: Autónomo / Empresa / Agents invitation. Catalog: Core (tools/list). The live catalog is authoritative: company type, membership, plan, connected apps and execution context can narrow this contract. Understand access.

Input

Agents / Managed run / agents schema

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Task UUID or identifier, such as MELS-818.",
      "type": "string"
    },
    "updates": {
      "additionalProperties": false,
      "properties": {
        "area_id": {
          "description": "Area UUID to move the Task into.",
          "type": "string"
        },
        "description": {
          "description": "Optional editable summary.",
          "type": "string"
        },
        "status": {
          "description": "Explicit lifecycle action, not a Run status.",
          "enum": [
            "done",
            "cancelled",
            "reopen"
          ],
          "type": "string"
        },
        "title": {
          "description": "Task title.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "id",
    "updates"
  ],
  "type": "object"
}

Autónomo / Company / Managed run / company / Managed run / freelancer schema

{
  "additionalProperties": false,
  "properties": {
    "id": {
      "description": "Task UUID or identifier, such as MELS-818.",
      "type": "string"
    },
    "updates": {
      "additionalProperties": false,
      "properties": {
        "description": {
          "description": "Optional editable summary.",
          "type": "string"
        },
        "status": {
          "description": "Explicit lifecycle action, not a Run status.",
          "enum": [
            "done",
            "cancelled",
            "reopen"
          ],
          "type": "string"
        },
        "title": {
          "description": "Task title.",
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "required": [
    "id",
    "updates"
  ],
  "type": "object"
}

Output

The updated compact Task projection: id, identifier, title, status, and any populated optional context. The result uses MCP content blocks; JSON payloads are encoded in text and may also appear in structuredContent. Check isError before reading a success payload. The server does not currently declare an outputSchema, so treat additional fields as extensible. Result handling.

Example

Use an OAuth access token issued for this MCP resource (a Run token for Run-only tools). Replace example identifiers with values from your own account. Write actions change data.

curl --fail-with-body https://melso.ai/api/mcp \
  -H "Authorization: Bearer $MELSO_MCP_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  --data-binary @- <<'JSON'
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tasks_update",
    "arguments": {
      "id": "11111111-1111-4111-8111-111111111111",
      "updates": {
        "title": "Review the latest draft"
      }
    }
  }
}
JSON

Connect

Contracts and access

Core tools

Agents and managed-Run tools

Advanced tools

tasks_update

Input

Agents / Managed run / agents schema

Autónomo / Company / Managed run / company / Managed run / freelancer schema

Output

Example

​Input

​Agents / Managed run / agents schema

​Autónomo / Company / Managed run / company / Managed run / freelancer schema

​Output

​Example

Input

Agents / Managed run / agents schema

Autónomo / Company / Managed run / company / Managed run / freelancer schema

Output

Example