CRM

Edit an activity

Corrects an activity already logged: its kind, title, text, who it is assigned to, when it is due and when it happened. due_at is a PLAN and completed_at is a FACT and neither is ever written from the other — clearing completed_at reopens the activity, which is a correction rather than a completion. Only the fields you pass are touched and null clears one. To close an activity, call crm_complete_activity instead.

patch/api/v1/rest/crm/activities/{id}

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/crm/activities/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

The activity id, from crm_list_activities or crm_get_timeline.

Headers

X-Tenant-Idstring uuid

The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.

Request body

kind'task' | 'call' | 'meeting' | 'note' | 'email' | 'document'

call, meeting, task, note, email or document.

direction'inbound' | 'outbound' nullable

Only for a call or an email: who rang whom. null clears it.

titlestring

One line, in Italian.

bodystring nullable

What was said, or what has to be done. null clears it.

due_atstring date-time nullable

When it is PLANNED, ISO-8601 with a timezone: 2026-09-03T15:00:00Z. null removes the plan, and with it the deal’s next action.

completed_atstring date-time nullable

When it HAPPENED, ISO-8601 with a timezone. null reopens it — a correction, not a completion.

outcomestring nullable

How it went, in a few words.

duration_minutesinteger nullable

How long it took, in minutes.

assignee_user_idstring uuid nullable

Whose to-do list it sits in. A colleague’s user_id from custodo_list_members, or your own from custodo_whoami — the timeline shows an assignee by NAME, never by id. null leaves it in nobody’s.

Response

Done. data is the tool’s own answer.

oktrue required
dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.