CRM

Complete an activity

Marks an open activity done, which is what moves the deal’s next action forward and resets its idle clock. completed_at defaults to now, and backdating a call written up later is normal. outcome and duration_minutes are added to what is already there and never clear it. An activity that is ALREADY completed is refused — moving that moment would rewrite what the reports counted — so correct one with crm_update_activity instead.

post/api/v1/rest/crm/activities/{id}/complete

Request

  • Base URL: https://api.custodo.ai
  • URL: https://api.custodo.ai/api/v1/rest/crm/activities/{id}/complete
  • 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

completed_atstring date-time

When it happened, ISO-8601 with a timezone. Defaults to now; backdating a call written up later is normal.

outcomestring

How it went, in a few words. Never clears what is already there.

duration_minutesinteger

How long it took, in minutes.

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.