heruAPI
Workers

Remove a worker

LiveServed by the v1 API in development with the same checks as production; production opens on the same contract. The capabilities from before v1 keep running in production at the path your account team gives you.

DELETE
/workers/{id}

Stops all services for the worker. Records already issued are kept as the law requires.

Needs the workers:write scope.

Authorization

oauth2 workers:write
headerAuthorizationBearer <token>

OAuth 2.0 client credentials. Exchange your client_id and client_secret at /oauth/token of the environment for a bearer token valid for one hour. The playground of every operation asks for your own client and keeps it in your browser tab only.

Scope: workers:write

Path parameters

id*string

The worker id.

Match^wrk_[0-7][0-9a-hjkmnp-tv-z]{25}$

Response body

Removed

curl -X DELETE 'https://api.dev.b2b.heru.app/v1/workers/wrk_01m4rg2a7kf1z8v3c6n9d5t4hq'
Empty
© 2026 Kuarto Inc. (heru)heru.appQuestions about your integration? Contact your heru account team.