EndpointsCogents

Patch cogent record

PATCH/v2/cogents/{cogent_id}/c/{collection}/{key}

Replaces some top-level fields of a live record as its next revision; the merged body must still fit its collection.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

cogent_id*Cogent Id

Cogent ID (its player ID).

Match^ply_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
collection*Collection

Collection name.

key*Key

Record key. It may contain /.

Header Parameters

x-cogent-agent?|

Which agent is writing, recorded with the write: hub, or a part of one such as hub/foreman.

Request Body

application/json

set*

Top-level fields to replace; the others are kept.

base_rev?|

The revision this write was made against; a stale one is refused with 409 and the current record. Omit it to write unconditionally.

message?|

Why, in a few words; kept with the revision.

idempotency_key*Idempotency Key

Caller-chosen key for this write, unique within the caller's credential. A retry with the same key and the same write returns the original result; the same key with another write is refused. Keys starting with permit: are the server's.

Length1 <= length <= 200
agent?|

Which agent is writing, recorded with the write: hub, claude-code@laptop, or a part of one such as hub/foreman. Overrides the X-Cogent-Agent header.

curl -X PATCH "https://softmax.com/api/observatory/v2/cogents/string/c/string/string" \  -H "Content-Type: application/json" \  -d '{    "set": {},    "idempotency_key": "string"  }'
{  "collection": "string",  "key": "string",  "rev": 0,  "at": "2019-08-24T14:15:22Z",  "author": {    "role": "coach",    "agent": "string"  },  "message": "string",  "deleted": true}