API referenceLists
Create a list
Send an Idempotency-Key to retry safely: a repeated request with the same key
returns the list created the first time instead of a second list.
Free.
Authorization
bearerAuth AuthorizationBearer <token>
Your API key, sent as Authorization: Bearer rc_live_….
In: header
Header Parameters
Idempotency-Key?string
Makes a retry safe. A request repeated with the same key within 24 hours returns
the first response (with Idempotent-Replayed: true) instead of acting twice.
Reusing a key with a different body returns 422; retrying while the first
request is still running returns 409. Use a random UUID.
Length
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A new list.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/lists" \ -H "Content-Type: application/json" \ -d '{ "name": "string" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "object": "list", "name": "string", "description": "string", "emoji": "string", "tags": [ "string" ], "item_count": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}