Quickstart

Create a projectCopy Anchor Link

A project holds one site's models, entries, media and keys.

1. On Projects, choose Create project.
2. Enter a Project name, such as Northpeak Outdoor.
3. Choose Create.

Capa opens the new project. Already have a project? Open it and skip this step.

Create a modelCopy Anchor Link

A model is a content type, such as an article or a product.

1. Choose Models in the sidebar, then New model.
2. Enter Article in Unique Model Name. The Namespace fills in as article. That is the name the API uses.
3. Choose Create Model.

Every new model starts with a title field.

Add a fieldCopy Anchor Link

1. Open the model's row menu and choose Edit fields.
2. Under the card of fields, choose Add field, then Rich Text.
3. In the field's settings, set Name to Body. Its namespace becomes body.
4. Choose Done, then Save fields in the top bar.

Fields are saved only when you choose Save fields.

Write and publish an entryCopy Anchor Link

1. Choose Content in the sidebar, then New content, then Article.
2. Fill in Title and Body.
3. Choose Publish.

Publish saves and publishes in one step. Save draft saves without publishing, and a production key never sees a draft.

Create a keyCopy Anchor Link

1. Open Developers > Keys and choose New key.
2. Set Name to Website.
3. Leave Environment on Production.
4. Under Grants, choose Read only.
5. Choose Create key, and copy the key.

Read itCopy Anchor Link

Put the key in an environment variable, then read the model's entries:

export CAPA_KEY=cap_live_...

curl "https://cdn.capacms.com/api/entries/article?select=title,body" \
  -H "x-api-key: $CAPA_KEY" \
  -H "Capa-Version: 2026-10-01"

You get your entry back:

{ "data": [
    { "id": "…3a", "model": "article", "status": "published",
      "fields": { "title": "Winter Field Guide 2026: Layering Above Treeline",
                  "body": "The cherries came in late this year…" } } ],
  "page": { "limit": 25, "hasNext": false, "next": null, "hasPrev": false, "prev": null },
  "meta": { "version": "2026-10-01", "contract": 1, "environment": "production", "requestId": "req_0f3c…" } }