POST /api/memories/{memory_id}/transfer

POST /api/memories/{memory_id}/transfer

Transfer Memory

Authentication: Authorization: Bearer <key> or X-API-Key: <key>. Create keys at developers.cognitivx.io/keys.

Parameters

Name	In	Type	Required	Description
`memory_id`	path	string	Yes	-
`Idempotency-Key`	header	string \| null	No	-
`X-Org-ID`	header	string \| null	No	-

Request body

A JSON request body is required.

Field	Type	Required	Description
`to_agent_slug`	string	Yes	-
`actor_agent_slug`	string \| null	No	-

Example request

curl -X POST https://api.cognitivx.io/api/memories/{memory_id}/transfer \
  -H "Authorization: Bearer icog_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to_agent_slug": "string",
    "actor_agent_slug": null
  }'

Example response

200 application/json

{
  "memory_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "transferred_to": "string",
  "archived_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "new_memory_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Responses

Status	Description
`200`	Success. Returns the response body shown below.
`422`	Request validation failed. `detail` lists each offending field.