Marfa Docs
Sources

List sources

Returns the sources you can see, each with its name and mark: your own, those you claim, and those of items you can read. keys.manage and the owner see every source in use or named.

GET
/sources

Authorization

headerAuthorizationBearer <token>

Authenticate with an API key (marfa_k1_…) or an OAuth access token (marfa_at_…).

Response body

Returns every source you can see, ordered by code.

application/json
  1. response

A page holding every source.

data*array<>

Every source.

next_cursor*|

Always null: Marfa returns every source in one page.

curl -X GET 'http://localhost:8600/sources'
{  "data": [    {      "source": "string",      "name": "string",      "name_from": "set",      "mark": "string"    }  ],  "next_cursor": "string"}

POSTMark inbound deliveries handled

Marks each named delivery handled, with an outcome, and returns them in the order you named. The first mark stands: marking a delivery again returns it unchanged.

GETGet a source

Returns a source's name and mark. A source needs no item or key to be read, but you see only your own, those you claim and those of items you can read, unless you hold keys.manage.