TasksV3

Create task

Beta

POST

Request

This endpoint expects an object.

encounter_id

UUIDRequired

task_type

enumRequired

description

stringRequired

work_queue_id

stringRequired

blocks_claim_submission

booleanOptional

assignee_user_id

UUIDOptional

Response

This endpoint returns an object

task_id

UUID

encounter_id

UUID

task_type

enum

description

string

blocks_claim_submission

boolean

external_id

string

patient_name

string

patient_external_id

string

status

enum

notes

list of objects

created_at

datetime

updated_at

datetime

The time of most recent update to the task only

agg_updated_at

datetime

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

date_of_service

date

assignments

list of objects

payer_name

stringOptional

payer_id

stringOptional

category

enumOptional

POST

1 curl -X POST https://api.joincandidhealth.com/api/tasks/v3 \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6   "task_type": "CUSTOMER_DATA_REQUEST",
7   "description": "string",
8   "work_queue_id": "string"
9 }'

200Successful

1 {
2   "task_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
3   "encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
4   "task_type": "CUSTOMER_DATA_REQUEST",
5   "description": "string",
6   "blocks_claim_submission": true,
7   "external_id": "string",
8   "patient_name": "string",
9   "patient_external_id": "string",
10   "status": "finished",
11   "notes": [
12     {
13       "task_note_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
14       "text": "string",
15       "created_at": "2023-01-01T00:00:00Z",
16       "author_name": "string",
17       "author_organization_name": "string"
18     }
19   ],
20   "created_at": "2023-01-01T00:00:00Z",
21   "updated_at": "2023-01-01T00:00:00Z",
22   "agg_updated_at": "2023-01-01T00:00:00Z",
23   "date_of_service": "2023-01-01",
24   "assignments": [
25     {
26       "task_assignment_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
27       "assignee_user_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
28     }
29   ],
30   "payer_name": "string",
31   "payer_id": "string",
32   "category": "other"
33 }

Built with

1	curl -X POST https://api.joincandidhealth.com/api/tasks/v3 \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
6	"task_type": "CUSTOMER_DATA_REQUEST",
7	"description": "string",
8	"work_queue_id": "string"
9	}'

1	{
2	"task_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
3	"encounter_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
4	"task_type": "CUSTOMER_DATA_REQUEST",
5	"description": "string",
6	"blocks_claim_submission": true,
7	"external_id": "string",
8	"patient_name": "string",
9	"patient_external_id": "string",
10	"status": "finished",
11	"notes": [
12	{
13	"task_note_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
14	"text": "string",
15	"created_at": "2023-01-01T00:00:00Z",
16	"author_name": "string",
17	"author_organization_name": "string"
18	}
19	],
20	"created_at": "2023-01-01T00:00:00Z",
21	"updated_at": "2023-01-01T00:00:00Z",
22	"agg_updated_at": "2023-01-01T00:00:00Z",
23	"date_of_service": "2023-01-01",
24	"assignments": [
25	{
26	"task_assignment_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
27	"assignee_user_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32"
28	}
29	],
30	"payer_name": "string",
31	"payer_id": "string",
32	"category": "other"
33	}