Skip to main content
PATCH
Actualizar una tarea
Updates a task in place. Only the fields you send are written. Completing a task is a status change, not a separate endpoint.

Endpoint

Required scope

crm:tasks:write

Headers

Path parameters

Body

All fields optional. Send only what changes.

Example request

Response

200 OK

Returns the updated task, same shape as GET /v1/crm/tasks/:id.

400 Bad Request

A due_at that is not valid ISO 8601, a priority outside the allowed set, or a property the endpoint does not accept.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the crm:tasks:write scope.

404 Not Found

No task with that id, or the task belongs to a different company.

Operational notes

  • status is not validated against a list. A typo like complete is accepted and stored, and the task then drops out of any ?status=completed filter. Pin the exact strings your integration writes.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

id
string
required

Body

application/json
title
string
assigned_to
string
status
string
priority
enum<string>
Available options:
low,
medium,
high,
urgent
due_at
string

Vencimiento en ISO 8601

description
string

Response

200 - application/json
task
object
required