Simulations

Revoke agent access as test customer

Remove an agent's access to a test customer, acting as the customer

post/simulations/customers/{customerId}/agents/{agentId}/revoke

Request

Base URL
https://api.sandbox.natural.com
URL
https://api.sandbox.natural.com/simulations/customers/{customerId}/agents/{agentId}/revoke
Auth
HTTP bearer

customerIdstring required

Customer party ID (pty_*).

agentIdstring required

Agent ID (agt_*).

Idempotency-Keystring required

Unique key for safely retrying a request without creating duplicates.

X-Instance-IDstring nullable

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Successful Response

Oct 19, 2026020f3c6963c7 Revision changes
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
Sep 2, 2026c7c12da5915f Revision changes
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added the optional property /// to the response with the status