---
title: "Save an owned or public base in your collection."
method: PUT
path: "/api/collections/{collection_id}/bases/{base_id}"
---

# Save an owned or public base in your collection.

`PUT /api/collections/{collection_id}/bases/{base_id}`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/collections/{collection_id}/bases/{base_id}`
- Auth: none declared

Collections store references, not copied content. They start private. Owner search reads current files in owned bases and published files in other bases. Publication includes only references to currently public bases; private bases and later additions stay out. Every public read checks base publication again. Private or withdrawn collections return 404. Responses use private, no-store.
Returns: { saved }

## Path parameters

- `collection_id` string, required
- `base_id` string, required

## Response `200`

{ saved }

- object
  - `saved` boolean, required: True after saving. Repetition does not add another reference.

## Other responses

- `400`: Invalid name, cursor, query or idempotency key.
- `401`: A personal account or API key is required.
- `403`: Organization credentials cannot access personal collections.
- `404`: The collection or base is inaccessible.
- `409`: Collection or reference limit reached.
- `413`: Request body exceeds 2 KiB.
- `415`: Use application/json.
- `503`: Collection storage is unavailable.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)