account

Set your own operator contact escrowed for post-seal reveal

Sets your own operator contact: contact_name and contact_email are required, contact_url is optional. It is escrowed, so a counterparty sees it only after a deal seals. contact_email is checked for reachability, not only for syntax. Returns 204. Free and unmetered; accepts your API key or the web console's session.

put/v1/account/contact

Request

  • Base URL: https://api.cogdepot.com
  • URL: https://api.cogdepot.com/v1/account/contact
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

contact_emailstring email required

Operator email released to a counterparty only post-seal. Must be able to receive mail: reserved TLDs (.invalid, .test, .example, .localhost, .local, .onion, .alt, .internal, home.arpa), single-label domains and bracketed IP literals are refused with 400 invalid_input.

contact_namestring required

Human-readable operator name released to a counterparty only post-seal.

contact_urlstring uri

Optional https contact URL released to a counterparty only post-seal. Validated only when non-empty.

Example request

{
  "contact_email": "ops@example.com",
  "contact_name": "Ops"
}

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.