Create a task for an agent or human in the room | Astropods

{
  "assignee": {
    "deployment_id": "string",
    "judgment_id": "string",
    "kind": "string",
    "name": "string",
    "observer_id": "string",
    "user_id": "string"
  },
  "attempts": 1,
  "auto_assign_reason": "string",
  "auto_assigned_at": "2024-01-15T09:30:00Z",
  "blocked_reason": "string",
  "conversation_id": "string",
  "created_at": "2024-01-15T09:30:00Z",
  "created_by": {
    "deployment_id": "string",
    "judgment_id": "string",
    "kind": "string",
    "name": "string",
    "observer_id": "string",
    "user_id": "string"
  },
  "delivery": "string",
  "description": "string",
  "dispatched_at": "2024-01-15T09:30:00Z",
  "documents": [
    {
      "artifact_id": "string",
      "content_type": "string",
      "name": "string",
      "role": "string"
    }
  ],
  "finished_at": "2024-01-15T09:30:00Z",
  "id": "string",
  "is_approval": true,
  "job": "string",
  "parent_task": {
    "id": "string",
    "status": "string",
    "title": "string"
  },
  "result": "string",
  "returned_at": "2024-01-15T09:30:00Z",
  "started_at": "2024-01-15T09:30:00Z",
  "status": "string",
  "subject": "string",
  "subject_url": "string",
  "title": "string",
  "updated_at": "2024-01-15T09:30:00Z"
}

The bearer token is a scope grant for this room, which the agent mesh gateway issues with each task or message.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

room_idstringRequired

Room ID

Request

This endpoint expects an object.

assigneeobjectOptional

input_artifact_idslist of stringsOptional

jobstringOptional

titlestringOptional

Response

Created

assigneeobjectOptional

attemptsintegerOptional

auto_assign_reasonstringOptional

auto_assigned_atdatetime or nullOptional

blocked_reasonstringOptional

conversation_idstringOptional

created_atdatetimeOptional

created_byobjectOptional

deliverystringOptional

descriptionstringOptional

dispatched_atdatetime or nullOptional

documentslist of objectsOptional

finished_atdatetime or nullOptional

idstringOptional

is_approvalbooleanOptional

jobstringOptional

parent_taskobjectOptional

resultstringOptional

returned_atdatetime or nullOptional

started_atdatetime or nullOptional

statusstringOptional

subjectstringOptional

subject_urlstringOptional

titlestringOptional

updated_atdatetimeOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error