Skip to main content
DELETE
Remove appointment codes
This is an asynchronous operation. The request returns a job_id immediately, and a webhook is sent when the operation completes. Codes that are not on the encounter are ignored.
The body is the same shape as Add Diagnosis Codes: each code is { "type": "icd10", "code": "..." }, and you can remove one or many in a single request.

Example Request

Example Response

Webhook

On completion we send a codes.removed event (or codes.failed on error). not_found lists codes that were not on the encounter.
See Operation Events for the failure payload and error codes.

Authorizations

client_id
string
header
required
client_secret
string
header
required
access_token
string
header
required

Path Parameters

appointment_id
string
required

Cobalt appointment ID.

Example:

"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4"

Body

application/json
codes
object[]
required

ICD-10 diagnosis codes to add or remove. CPT/procedure codes are not yet supported.

Example:
callback_urls
string[]

URLs to receive the completion webhook for this operation, in addition to the account webhook.

Example:
expires_at
string<date-time> | null

Optional ISO 8601 timestamp with an explicit timezone offset, in the future when submitted. Cobalt starts no new operation attempt after this deadline and reports reasons[].code EXPIRED. An attempt already in progress, including write reconciliation, may finish after it.

Example:

"2027-06-15T14:30:00Z"

Response

Operation queued for processing

success
boolean
required
Example:

true

message
string
required
Example:

"Operation queued for processing"

job_id
integer
required
Example:

12345