iotoms Docs

Delete a Tally mapping

DELETE
/api/v1/integrations/tally/mappings/{id}

Removes one Tally master mapping by its numeric ID (from List Tally mappings). Invoices that need that record will show it as missing again in the readiness check.

How to use it

  1. Get the mapping ID from List Tally mappings.
  2. Send the delete; the mapping is removed, and invoices that use that record will show it as missing until it is mapped again.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*integer

ID of the record.

Formatint64

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the request: SUCCESS when it worked; errors return an error status with the reason in message.

message*string

Short human-readable message describing the outcome.

data?|

A short text result; for a deleted draft settlement this is the ID of the run that was deleted.

Example Request
curl -X DELETE 'https://beta.iotoms.com/api/v1/integrations/tally/mappings/0' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": "string"}