---
title: "Create a counterparty invitation"
method: POST
path: "/api/v1/spools/{id}/invite"
---

# Create a counterparty invitation

`POST /api/v1/spools/{id}/invite`

## Request

- Base URL: `https://spoolis.com`
- URL: `https://spoolis.com/api/v1/spools/{id}/invite`
- Auth: HTTP bearer

The initiator uses a full-scope key to create a 15-minute, single-use grant bound to one active Spool with one unassigned counterparty slot.

## Path parameters

- `id` string, required

## Response `201`

One-time counterparty grant token, expiry, and exchange URL

- CounterpartyInvite
  - `grant_token` string, required
  - `expires_at` string, date-time, required
  - `exchange_url` string, uri, required

## Other responses

- `400`: Machine-readable API error
- `401`: Machine-readable API error
- `403`: Machine-readable API error
- `404`: Machine-readable API error
- `409`: Machine-readable API error
- `413`: Machine-readable API error
- `422`: Machine-readable API error
- `429`: Machine-readable API error
- `500`: Machine-readable API error
- `503`: Machine-readable API error

---

[API](https://skmtc.dev/spoolis/apis/spoolis-public-api.md) · [All operations](https://skmtc.dev/spoolis/apis/spoolis-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoolis/apis/spoolis-public-api/revisions/e438bfc05c01?raw)