> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Blueprints

> List the blueprints the caller can draft from.

> [!NOTE]
>
> **Preview.** This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive `403 mcp_not_enabled`. See the [preview overview](/preview).

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](/api-reference/drafts/create-draft) to draft from it.

This route returns the same fields as [List Templates](/api-reference/templates/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](/api-reference/blueprints/get-blueprint).

```bash cURL theme={null}
curl "https://api.wordsmith.ai/api/v1/blueprints?query=NDA" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.