Skip to main content
POST
/
items
Create an item
curl --request POST \
  --url https://api.example.com/items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "properties": {},
  "id": "<string>",
  "state": "<string>",
  "timestamp": "<string>",
  "source": "<string>",
  "source_id": "<string>",
  "device": "<string>",
  "capture_latitude": 123,
  "capture_longitude": 123,
  "tags": [
    "<string>"
  ],
  "edges": {}
}
'
{
  "item": {
    "id": "<string>",
    "type": "<string>",
    "properties": {},
    "version": 123,
    "schema_version": 123,
    "source": "<string>",
    "timestamp": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "tenant_id": "<string>",
    "source_id": "<string>",
    "device": "<string>",
    "capture_latitude": 123,
    "capture_longitude": 123,
    "edges": {},
    "extensions": {}
  },
  "metadata": {
    "item_id": "<string>",
    "tags": [
      "<string>"
    ],
    "extensions": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.myme.so/llms.txt

Use this file to discover all available pages before exploring further.

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