Ga naar inhoud
buildinglinksbuildinglinks

Anchor now

POST
/api/v1/evidence/anchors
curl --request POST \
  --url https://example.com/api/v1/evidence/anchors \
  --cookie bl_%3Cslug%3E_session=%3Cbl_%3Cslug%3E_session%3E

Anchors the head of the chain at the notary now, instead of at the next minute. Says so when there is nothing new.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

OK.

Media typeapplication/json
One of:

An anchor: the notary’s receipt for the head of the chain at seq.

object
id
required
string
seq
required
integer format: int64
head
required
string
anchored_at
required
string format: date-time
receipt
required

JWS by the Trust Authority over {participant, seq, head, anchored_at}.

string
qualified

A qualified timestamp on the receipt (decisions #45), once the notary has stamped it.

object | null

Example generated

{
  "id": "example",
  "seq": 1,
  "head": "example",
  "anchored_at": "2026-04-15T12:00:00Z",
  "receipt": "example",
  "qualified": "example"
}

401

Section titled “401”

No valid session, DPoP-bound token or API key.

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}

403

Section titled “403”

The caller lacks the role this operation needs; or a change with the session cookie came from a page of another site (cross_site_request, decisions #83).

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}

500

Section titled “500”

The notary refused or could not be reached.

Media typeapplication/json

The body of every failed call to a management API.

object
error
required
object
code
required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string
message
required

For people; may change between versions.

string

Example 

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}