Create a mutation

POST

https://api.t-dx.com/api/rest/v1/holdings/:holdingId/mutations

POST

/api/rest/v1/holdings/:holdingId/mutations

curl -X POST https://api.t-dx.com/api/rest/v1/holdings/holdingId/mutations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "result": {
    "id": "string",
    "investorId": "string",
    "issuerClientAccountId": "string",
    "instrumentId": "string",
    "balanceId": "string",
    "quantity": "string",
    "sourceType": "HOLDING_SOURCE_TYPE_ISSUER",
    "warranted": true,
    "includeInBalance": true,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "deletedAt": "2024-01-15T09:30:00Z",
    "promotionId": "string",
    "instrument": {
      "id": "string",
      "blockchain": "string",
      "decimals": 1,
      "contractAddress": "string",
      "fullName": "string",
      "symbol": "string"
    },
    "externalAddress": {
      "id": "string",
      "address": "string"
    },
    "promotion": {
      "id": "string",
      "tokensLockedUntil": "2024-01-15T09:30:00Z",
      "subscriptionPrice": "string"
    },
    "investor": {
      "id": "string",
      "clientAccountId": "string"
    },
    "tokenClaim": {
      "id": "string",
      "investorExternalAddressId": "string",
      "transactionHash": "string",
      "createdAt": "2024-01-15T09:30:00Z",
      "status": "TOKEN_CLAIM_STATUS_CREATED"
    },
    "registeredAt": "2024-01-15T09:30:00Z",
    "investorExternalAddressID": "string",
    "holderId": "string"
  }
}

This endpoint mutates a given holding

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

holdingIdstringRequired

Request

This endpoint expects an object.

investorIdstringOptional

actionenumOptional

Allowed values:

quantitystringOptional

Response

A successful response.

resultobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

503

Service Unavailable Error