Skip to main content
POST
Create an action item

Authorizations

Authorization
string
header
required

Bearer API key. Two modes: sv_live_* for production data, sv_test_* for a parallel sandbox dataset that doesn't count against plan limits. Issued from Settings → Developers in the SiteVisit app.

Headers

Idempotency-Key
string

Optional idempotency key, scoped to the authenticated account. Repeating a write with the same key + same body returns the original response; same key + different body returns 422 idempotency_key_in_use.

Maximum string length: 255

Body

application/json
site_visit_id
string
required
title
string
required
Required string length: 1 - 200
description
string
Maximum string length: 5000
category
string
Maximum string length: 100
location
string
Maximum string length: 200
priority
enum<string>
Available options:
LOW,
MEDIUM,
HIGH
assignee
string
Maximum string length: 100

Response

Resource created.

id
string
required
siteVisitId
string
required
propertyId
string
required
propertyName
string
required
title
string
required
priority
enum<string>
required
Available options:
LOW,
MEDIUM,
HIGH
status
enum<string>
required
Available options:
OPEN,
IN_PROGRESS,
DONE
evidenceImageUrls
string[]
required
isTest
boolean
required

True for objects created via a sv_test_* API key. Mirrors the parent SiteVisit's mode.

order
integer
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
description
string | null
category
string | null
location
string | null
assignee
string | null
timestampSec
number | null
transcriptQuote
string | null
completedAt
string<date-time> | null
completedBy
string | null
completionNote
string | null
completionPhotoUrl
string | null