# Create knowledge

Source: <https://everruns.com/docs/api/operations/create_knowledge/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Knowledge & memory](https://everruns.com/docs/api/groups/knowledge-memory/)/Create knowledge

# Create knowledge

Preview

Give agents persistent memory and versioned file collections. Manage sources, files and optional search indexes.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/knowledge`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Request Bodyrequired

Media typeapplication/json

A file collection with optional indexing, provider selection and path exclusions.

object

**description**

Human-readable purpose of the collection, available during progressive disclosure.

string

**embedding_model_id**

Organization embedding model; required when hybrid indexing is enabled.

string | null

**indexer_id**

Optional organization search account. Omit to use the local index backend.

string | null format: uuid

**indexing**

Whether files remain unindexed, use keyword search, or also use embedding retrieval.

string

Allowed values: off lexical hybrid

**name**

required

Collection name; `everruns-docs` is reserved for the predefined documentation snapshot.

string

**rules**

Path-glob arrays named `ingest_exclude`, `index_exclude` and `read_exclude`.

## Responses

200Created collection

### 200

Created collection

Media typeapplication/json

### Example generated

```json
example
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/knowledge';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"description":"example","embedding_model_id":"example","indexer_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","indexing":"off","name":"example","rules":"example"}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/knowledge \
  --header 'Content-Type: application/json' \
  --data '{ "description": "example", "embedding_model_id": "example", "indexer_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "indexing": "off", "name": "example", "rules": "example" }'
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Created collection

No response body example is declared for this status.

## Matching endpoints