Create a new Context Item

post

https://godly.ai/api/projects/{projectId}/context-items

Creates a new context item. The context items are indexed for appending into related prompts using the with-context endpoint.

You can optionally add references and types to the context item.

Path Params

projectId

string

required

ID of project

Query Params

maxTokens

number

The maximum amount of tokens for the context item. If the context item exceeds this amount, it will fail unless include the exceedTokensStrategy to specify the result. Defaults to 800.

exceedTokensStrategy

string

enum

How to handle context items that exceed the maxTokens. Defaults to 'fail'. fail will return an error, split will split the context item into multiple context items with none larger than the maxTokens, and truncate will truncate the context item to the maxTokens.

Allowed:

Body Params

value

string

required

The string you want to index as a Context Item

string

The ID of the Context Item. Will be autogenerated if not provided. Useful for mapping to your own IDs from databases or other systems.

reference

string

A reference url you want to filter by or link to in the future

type

string

The type of the Context Item. This is used to filter by in the future.

200Returns an array of the newly created Context Item(s)