EndpointsCogents

Append cogent log lines

POST/v2/cogents/{cogent_id}/logs/{log}

Appends lines to a log and returns their seqs, which follow the log's last with no gaps.

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}$
log*Log

Log name.

Header Parameters

x-cogent-agent?|

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

Request Body

application/json

lines*array<>

Lines to append, in order, each in the log's shape; at least one.

Items1 <= items <= 1000
at?|

When the lines happened, if the writer stamped them already; stored as each line's at. Omitted, the server stamps now. It labels the lines and orders nothing: seqs follow the order appends commit. At most 5 minutes ahead of the server's clock; any earlier time is kept.

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
curl -X POST "https://softmax.com/api/observatory/v2/cogents/string/logs/string" \  -H "Content-Type: application/json" \  -d '{    "lines": [      {}    ],    "idempotency_key": "string"  }'
{  "first": 0,  "last": 0}