Put Record

PUT 
/signature/:signature_id/record

Create or fully replace the Record attached to a signature.

This is a full-replace upsert: the stored Record becomes exactly the provided Record (last write wins, no field merging). It may be called for any signature registered by the partner, regardless of when the signature was registered.

A signature without a Record is treated as private.

Supports optimistic concurrency: pass the current ETag in an If-Match header to make the write conditional; a stale precondition returns 412 Precondition Failed.

Request

Responses

204

The Record was stored

Response Headers

ETag
The signature's current revision as a strong validator, e.g. "5". Pass it back in an If-Match header on a later write to make that write conditional.
Example: "5"
SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61

400

The request was rejected. A validation failure lists every offending field in details; other failures carry message only.

Response Headers

SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61

401

An authorization error has occurred.

Response Headers

SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61

403

An authorization error has occurred.

Response Headers

SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61

404

The requested resource was not found.

Response Headers

SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61

409

The signature is revoked; its Record can no longer be modified.

Response Headers

SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61

412

The If-Match precondition did not match the signature's current revision; the Record was not modified. Re-read the Record and retry with the new ETag.

Response Headers

SASHA-Request-ID
The identifier of this request, set on every response. Quote it when contacting SASHA support: it is what joins your call to the server-side logs. On an error response the same value is repeated in the payload's request_id.
Example: 8f14e45f-ceea-467a-9f0b-2b3a2c5a7d61