Skip to content
API Reference
Lists

Create list

Creates a list from a template. Seeds properties, pipeline stages (when applicable), and default views — identical to the session-auth /default_app/create path. API-key callers are fully supported; type is derived from template_id and must not be supplied.

POST/v2/prism/{teamId}/lists

Creates a list from a template. Seeds properties, pipeline stages (when applicable), and default views — identical to the session-auth /default_app/create path. API-key callers are fully supported; type is derived from template_id and must not be supplied.

x-api-key<token>

Public API key generated from Micro settings. Sent as the x-api-key header and validated by AWS API Gateway in front of the service.

In: header

Path Parameters

teamId*string
Formatuuid

Header Parameters

Idempotency-Key?string

A unique key (UUID or any opaque string up to 255 chars) for an authenticated POST, PUT, or PATCH request. The server retains the initial claim for 24 hours and replays a completed non-5xx response only when the method, path, and request body all match. Reusing a non-expired key with a different method, path, or body returns 409 idempotency_key_mismatch; reusing it after expiry returns 409 idempotency_key_stale, so use a new key. Replays include the idempotent-replay: true response header.

Length1 <= length <= 255

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://developers.micro.so/v2/prism/${MICRO_TEAM_ID}/lists" \  -H "x-api-key: $MICRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "template_id": "sales_deals"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "icon": "string",  "object_type": "organization",  "type": "string",  "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba",  "description": "string",  "created_at": "2019-08-24T14:15:22Z",  "views": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string"    }  ]}
micro.so