Skip to content

Popular

  • QuickstartDevelopers
  • AuthenticationBasics
  • WebhooksBasics
  • Upload a documentPOST /v1/read/documents
  • Get a document’s fieldsGET /v1/read/documents/{id}/fields
  • Extract your own fieldsREAD · Document Extraction
WORK menu

WORK · API

Get a mission

Where a mission stands, what it is waiting for, its trail and its results.

GEThttps://api.rowland.ai/v1/work/missions/{id}

Path parameters

  • idstringRequired

    The mission ID.

Returns

200OK. For failures, see Errors.

  • askingobject | null

    When the status is needs_you: what the Row Bot is asking for (approval, question or handoff) and what it wants to do.

  • trailobject[]

    Every step so far: when, by whom and what was done.

  • resultsobject[]

    What the mission produced, such as a runsheet or a spreadsheet.

curl "https://api.rowland.ai/v1/work/missions/msn_5Qe7yRb1Nc" \
  -H "x-api-key: $ROWLAND_API_KEY"

Response200

{
  "object": "mission",
  "id": "msn_5Qe7yRb1Nc",
  "row_bot": "owen",
  "status": "needs_you",
  "asking": {
    "id": "ask_2Tz6wLc9Pj",
    "kind": "approval",
    "action": "Send the curative request to the operator",
    "context": "Gap in the chain: 1961 deed to 1974 assignment. Draft ready."
  },
  "trail": [
    {
      "at": "2026-11-20T15:04:09Z",
      "by": "Owen",
      "did": "Read 14 documents for Section 12, Block 7"
    },
    {
      "at": "2026-11-20T15:06:31Z",
      "by": "Owen",
      "did": "Built the runsheet: 22 instruments"
    },
    {
      "at": "2026-11-20T15:06:40Z",
      "by": "Owen",
      "did": "Found a gap: 1961 deed to 1974 assignment"
    }
  ],
  "results": [
    {
      "kind": "runsheet",
      "title": "Runsheet · Section 12, Block 7",
      "file": "fil_8Mn3kQs6Xw"
    }
  ]
}