List Blueprints

List the blueprints the caller can draft from.

GET /api/v1/blueprints

cURL

curl "https://api.wordsmith.ai/api/v1/blueprints?query=NDA" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "cb3b96b2-fb48-47c4-bd41-e484a8eb2f0f",
      "name": "Mutual NDA",
      "description": "Our standard mutual non-disclosure agreement."
    }
  ],
  "cursor": null
}

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Lists the blueprints the caller can use. A blueprint is a document with placeholders that you fill to draft a new contract. Pass one to Create Draft to draft from it.

This route returns the same fields as List Templates, in the {items, cursor} page every new list route uses, and adds search and paging. GET /api/v1/templates keeps working and keeps its bare-array response.

You can read your organisation’s blueprints and the published global ones. Blueprints come back sorted by name.

Authentication

Requires an API key, or an OAuth token with blueprints:read. Tokens granted the older templates:read scope keep working.

Query parameters

query · string

Only blueprints whose name or description contains this text.

cursor · string

The cursor from the previous page.

limit · integer · default: "50"

Blueprints per page, up to 100.

Response

Returns 200 with a page of blueprints: id, name and description. Read the placeholders with Get Blueprint.

cURL

curl "https://api.wordsmith.ai/api/v1/blueprints?query=NDA" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "items": [
    {
      "id": "cb3b96b2-fb48-47c4-bd41-e484a8eb2f0f",
      "name": "Mutual NDA",
      "description": "Our standard mutual non-disclosure agreement."
    }
  ],
  "cursor": null
}