Update task

PATCH

/api/tasks/v3/:task_id

PATCH

/api/tasks/v3/:task_id

import requests
url = "https://api.taigabilling.com/api/tasks/v3/task_id"
payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.json())

{
  "task_id": "string",
  "encounter_id": "string",
  "task_type": "CUSTOMER_DATA_REQUEST",
  "description": "string",
  "blocks_claim_submission": true,
  "external_id": "string",
  "patient_name": "string",
  "patient_external_id": "string",
  "status": "finished",
  "notes": [
    {
      "task_note_id": "string",
      "text": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "author_name": "string",
      "author_organization_name": "string"
    }
  ],
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "agg_updated_at": "2024-01-15T09:30:00Z",
  "date_of_service": "2023-01-15",
  "assignments": [
    {
      "task_assignment_id": "string",
      "assignee_user_id": "string"
    }
  ],
  "payer_name": "string",
  "payer_id": "string",
  "category": "other",
  "configurable_rule_id": "string",
  "persisted_rule_id": "string",
  "organization_id": "string"
}

Updates a task on one of your encounters. Set status to addressed_by_provider_group once you have supplied or corrected the data the task requested; the billing team then re-reviews the claim. Status transitions are validated upstream and an invalid transition returns 4xx. A task you cannot reach returns 404.

Authentication

AuthorizationBearer

Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

Path parameters

task_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

statusenum or nullOptional

assignee_user_idstring or nullOptionalformat: "uuid"

blocks_claim_submissionboolean or nullOptional

Response

task_idstringformat: "uuid"

encounter_idstringformat: "uuid"

task_typeenum

descriptionstring

blocks_claim_submissionboolean

external_idstring

patient_namestring

patient_external_idstring

statusenum

noteslist of objects

created_atdatetime

updated_atdatetime

The time of most recent update to the task only

agg_updated_atdatetime

The time of most recent update to the task or any of its notes

date_of_servicedate

assignmentslist of objects

payer_namestring or nullOptional

payer_idstring or nullOptional

categoryenum or nullOptional

configurable_rule_idstring or nullOptionalformat: "uuid"

persisted_rule_idstring or nullOptionalformat: "uuid"

organization_idstring or nullOptionalformat: "uuid"

Errors

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error