Send a message to a delegate task | Runtype Documentation

curl -X POST https://api.runtype.com/v1/delegate-tasks/dlg_01jh0000000000000000000000/messages \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "message": "Yes, please proceed with deploying to the staging environment and notify the team via Slack once it'\''s done."
}'

{
  "accepted": true,
  "task": {
    "apiKeyId": "key_01jh1234567890abcdefghijkl",
    "clientName": "runtype-sdk-python",
    "clientVersion": "1.4.2",
    "completedAt": null,
    "createdAt": "2025-01-15T09:22:00Z",
    "error": null,
    "id": "dlg_01jh0000000000000000000000",
    "instruction": "Deploy the latest build to staging and notify the team when complete.",
    "lastEventSeq": 7,
    "modelRoundCount": 3,
    "organizationId": "org_01jh9876543210zyxwvutsrqpo",
    "question": null,
    "result": {
      "links": [
        {
          "label": "Staging Deployment Dashboard",
          "url": "https://dashboard.runtype.com/deployments/dep_01jh0000000000000000000001"
        }
      ],
      "modelRoundCount": 3,
      "summary": "Deployment to staging environment initiated successfully. Team notification sent via Slack to #deployments channel.",
      "toolCallCount": 5,
      "touchedEntities": [
        {
          "action": "created",
          "id": "dep_01jh0000000000000000000001",
          "kind": "Deployment",
          "name": "staging-deploy-v2.3.1"
        }
      ],
      "totalCost": 0.0042,
      "warnings": [
        "Staging environment was last deployed 14 days ago; consider reviewing environment variables."
      ]
    },
    "startedAt": "2025-01-15T09:22:05Z",
    "status": "running",
    "summary": "Deploying build v2.3.1 to staging environment and notifying team.",
    "toolCallCount": 5,
    "totalCost": 0.0042,
    "touchedEntities": [
      {
        "action": "created",
        "id": "dep_01jh0000000000000000000001",
        "kind": "Deployment",
        "name": "staging-deploy-v2.3.1"
      }
    ],
    "updatedAt": "2025-01-15T09:22:31Z",
    "userId": "usr_01jhaabbccddeeff00112233445"
  }
}

Answer a question the task asked (status input_required) or add a follow-up instruction to a running task. Only the principal that started the task (the same user, and the same API key when one started it) may message it, because the task keeps acting with that principal’s authority. API keys need DELEGATE_TASKS:WRITE.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

The task id (dlg_…).

Request

This endpoint expects an object.

messagestringRequired1-20000 characters

Response

Accepted

acceptedboolean

taskobject

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

503

Service Unavailable Error