Sign in

Get v0 city by city name mail

Changed on

Results are ordered (created_at DESC, id DESC) — newest messages first. A truncated response always carries next_cursor; passing it back returns the next page in the same order. Invalid or legacy cursors are rejected with a typed 400 (invalid-cursor).

get/v0/city/{cityName}/mail

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

cityNamestring required

City name.

Query parameters

indexstring

Event sequence number; when provided, blocks until a newer event arrives.

waitstring

How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.

cursorstring

Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.

limitinteger

Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.

agentstring

Filter by agent name.

statusstring

Filter by status (unread, all).

rigstring

Filter by rig name.

Response

OK

next_cursorstring

Cursor for the next page of results.

partialboolean

True when one or more rig providers failed and the list is not authoritative.

partial_errorsstring[] nullable

Per-provider errors when partial is true.

totalinteger required

Total number of messages matching the query.

Changes

  • 68d02733ae1cRevision changes
    • ▲

      for the query request parameter limit, default value 100 was added

    • ●

      for the query request parameter limit, the max was set to 1000.00