Create an item
Creates an item against its type schema and persists it. The server stamps id, created_at, version, and source (from the caller’s credential — not forgeable). Type-schema validation runs before any write.
If source_id is supplied and an existing non-trashed item in the tenant already has the same (source, source_id) pair, the call short-circuits to update — properties shallow-merge, tags replace if provided, edges replace per-type if provided. The HTTP status flips from 201 to 200; the response body is the updated item either way. See Items — natural-key upsert for the wider semantics.
An edges block on the request body creates the item and its outbound edges in one transaction; either the whole write succeeds or nothing persists. See Edges — atomic item + edges write.
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
Pass an API key (marfa_k1_...) or OAuth access token (marfa_at_...)