Create Beneficiary

Changed on

Create a new beneficiary for your organization to retire on behalf of.

post/beneficiary

Request

  • Base URL
    https://api.isometric.com/registry/v0
  • URL
    https://api.isometric.com/registry/v0/beneficiary
  • Auth
    HTTP bearer

Headers

x-client-secretstring required

A secret token identifying the client connecting to the API

Example:Syou3EZiO5vuMEgNyBeA8cjEMYOnQDwP

Request body

OR

Example request

{
  "beneficiary_name": "Acme Corporation",
  "beneficiary_domain": "acme.com"
}

Response

Successful Response

idstring required
namestring required
domainstring nullable required

Example response

{
  "id": "org_1GB56M1ST1S0GVNA",
  "name": "Isometric",
  "domain": "isometric.com"
}

Changes

    • breaking

      the / request property's minLength was increased from 0 to 1

    • warning

      the / request property's maxLength was set to 200

    • breaking

      the request's body type changed from object to no type

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added to the request body oneOf list

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status