curl --request POST \
--url 'https://response.stateset.com/api/v1/knowledge' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"knowledge": "string",
"metadata": {},
"force_create": true
}'
Add a knowledge-base document (near-duplicates update in place)
Write result
POST
/
api
/
v1
/
knowledge
curl --request POST \
--url 'https://response.stateset.com/api/v1/knowledge' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"knowledge": "string",
"metadata": {},
"force_create": true
}'
Request body
object
string
required
object
boolean
Response
Returnsobject.
Status codes
| Code | Meaning |
|---|---|
200 | Write result |
400 | Invalid request. issues names the offending field(s). |
401 | Missing, invalid, or expired API key. |
403 | The key lacks a required scope. |
409 | Conflict — either the creation ceiling was reached for this organization (agent_limit_reached), or a request with the same Idempotency-Key is still in flight (idempotency_in_progress); retry the latter after the first attempt settles. |
422 | The Idempotency-Key was already used with a DIFFERENT request body (idempotency_key_reused). Reuse a key only to retry the identical request. |
429 | Rate limit exceeded. |
Access
| Required scope | knowledge:write |
| Rate limit | 10 requests per minute |
curl --request POST \
--url 'https://response.stateset.com/api/v1/knowledge' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"knowledge": "string",
"metadata": {},
"force_create": true
}'