Skip to main content
POST
Create a CRM relationship task

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Required for every non-open scope. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.

Body

application/json
title
string
required

Task title

account
string

CRM account ID

body
string

Task body / longer description

confidence
string

Confidence in the task (0.0–1.0)

contact
string

Contact ID or identity

due
string

Due date/time

evidence
string

Evidence JSON array attached to the task event

idempotencyKey
string

Deduplicate repeated task creation

metadata
string

Metadata JSON object stored on the task

opportunity
string

CRM opportunity ID

owner
string

Owner, e.g. agent:main

priority
string

low|normal|high|urgent

source
string

Source label (default: cli)

taskType
string

Task type (e.g. follow_up, commitment, call)

Response

Success — body conforms to the @Returns schema.

changedCount
number
required
status
string
required
{key}
any