Skip to main content
POST

Authorizations

​
Authorization
string
header
default:Bearer sandbox_any_token_works
required

A 15-minute token bound to one patient and one enrollment, issued by POST /v1/oauth/token with the token-exchange grant. Treat it as opaque. When it expires, exchange a fresh assertion; there is no refresh token.

Headers

​
Idempotency-Key
string
required

A unique key per logical request, for example a UUID. Retrying with the same key and the same body within 24 hours returns the first response (with Idempotent-Replayed: true) instead of creating a duplicate. The same key with a different body is refused with 422 idempotency_key_reused.

Required string length: 8 - 255

Body

application/json

A dose taken (injected_at) or missed (missed: true). One of the two is required.

​
injected_at
string<date-time>
required

ISO 8601 in UTC.

Example:

"2026-10-26T14:05:00Z"

​
missed
boolean
default:false
​
scheduled_for
string<date>
Example:

"2026-10-26"

​
dose_mg
number
Example:

0.5

​
site
string

For example abdomen_left, abdomen_right, thigh_left, thigh_right, arm_left, arm_right.

Example:

"abdomen_left"

​
note
string
Maximum string length: 1000
Example:

"Slight redness at site"

​
external_id
string

Your own identifier, printable ASCII without spaces.

Required string length: 1 - 128
Pattern: ^[\x21-\x7E]+$
Example:

"inj-88213"

Response

Logged.

A dose taken (injected_at) or missed (missed: true). One of the two is required.

​
injected_at
string<date-time>
required

ISO 8601 in UTC.

Example:

"2026-10-26T14:05:00Z"

​
missed
boolean
default:false
required
​
id
string<uuid>
required
Example:

"0190f5c9-8091-72a3-9dc5-4e5f60718293"

​
log_date
string<date>
required

A calendar date in the patient's time zone.

Example:

"2026-10-26"

​
source
enum<string>
required
read-only

Set by the API from the caller. brand_api for brand servers, brand_app for patient tokens issued to a brand.

Available options:
app,
brand_app,
brand_api,
wearable,
coach,
ai,
system
Example:

"brand_app"

​
created_at
string<date-time>
required

ISO 8601 in UTC.

Example:

"2026-10-26T14:05:00Z"

​
updated_at
string<date-time>
required

When the log was last corrected; the same as created_at until then.

Example:

"2026-10-26T14:05:00Z"

​
scheduled_for
string<date>
Example:

"2026-10-26"

​
dose_mg
number
Example:

0.5

​
site
string

For example abdomen_left, abdomen_right, thigh_left, thigh_right, arm_left, arm_right.

Example:

"abdomen_left"

​
note
string
Maximum string length: 1000
Example:

"Slight redness at site"

​
external_id
string

Your own identifier, printable ASCII without spaces.

Required string length: 1 - 128
Pattern: ^[\x21-\x7E]+$
Example:

"inj-88213"