Work

Create Work Conversation Task

Give a task to a person from this channel: a task on the CRM task board, not an agent run.

The creator, organisation and channel come from the key and the URL, never the body. ownerUserId names the ASSIGNEE (the caller when omitted), who must be the caller or a human member of the conversation. Needs a seat in the channel; a person may start at most 30 new tasks per 10 minutes (429). A replayed Idempotency-Key returns the original task with duplicate: true; the same key with a different body is a 409.

post/work/conversations/{conversation_id}/tasks

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/work/conversations/{conversation_id}/tasks
  • Auth: HTTP bearer

Path parameters

conversation_idstring required

Conversation id (or channel key)

Headers

Idempotency-Keystring nullable

Retry-safety key. Replaying one returns the ORIGINAL result with duplicate: true instead of writing twice. Omit it and the server mints a single-use key, which means a retried request writes again: send your own for anything you may retry.

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

titlestring required
ownerUserIdstring nullable

The ASSIGNEE's user id (the caller when omitted).

dueAtstring date-time nullable

A calendar day YYYY-MM-DD; only the date is kept.

descriptionstring nullable

Plain text.

Response

Successful Response

dataWorkChannelPayload required

A Work channel, chat, output, task, decision or activity document, as the app returns it.

Changes

No recorded changes to this operation across all 2 revisions of this API.