POST/v1/poolspools:write

Create a pool

Run a request

POST/v1/pools

Base URL

Request body (JSON)

Resolved URL

POSThttps://coldos.justgotwyrd.com/api/v1/pools

Paste an API key in the bar at the top of the page to enable Execute.

Parameters

Body parameters

namestringrequired
Display name.
descriptionstringoptional
Optional one-paragraph description.
is_privatebooleanoptionaldefault false
If true, only admins can see the pool.

Responses

400Invalid request — see `error.message`.
401Missing or invalid API key.
403Authenticated, but the key lacks the required scope.
404The referenced resource does not exist or is not visible to your key.
429Rate limit exceeded — see `Retry-After`.
500Unexpected server error. Safe to retry with idempotency-key.

Code samples

curl -X POST "https://coldos.justgotwyrd.com/api/v1/pools" \
  -H "Authorization: Bearer $COLD_OS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "name": "APAC mid-market — Q2",
      "description": "Hand-picked from Apollo CSV import on 2026-04-22."
    }'

Response · 200

{
  "id": "f1aabb22-3344-5566-7788-9900aabbccdd",
  "name": "APAC mid-market — Q2",
  "description": "Hand-picked from Apollo CSV import on 2026-04-22.",
  "is_private": false,
  "member_count": 312,
  "created_at": "2026-04-22T11:24:00.000+05:30"
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.