Skip to main content
POST
Create an item

Authorizations

Authorization
string
header
required

Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)

Body

application/json
type
string
required
properties
object
id
string
state
string
timestamp
string
source
string
source_id
string
tier
enum<string>
Available options:
library,
feed
device
string
capture_latitude
number
capture_longitude
number
tags
string[]
edges
object

Response

Item updated via natural-key upsert. Returned when both source (stamped from the credential) and request source_id resolve a non-trashed item in the caller's tenant — the request is treated as an idempotent re-sync of the upstream entry.

item
object
required
metadata
object
required