An API is available for those running multiple explorers or users who prefer a programatic approach to Autoscout management.
You will need a valid API key to use the API → https://deploy.blockscout.com/api-keys
API Base URL : The base URL for the Autoscout API is https://autoscout.services.blockscout.com
Create an Instance
Send a POST request to the /api/v1/instances endpoint with the required configuration.
Request Headers
Request Body
curl example
Response
x-api-key: YOUR_API_KEY
Content-Type: application/json
Start Instance
Send a POST request to/api/v1/instances/{instance_id}/status:update
Use the instance id returned in the previous step.
Request Headers
Request Body
curl Example
Response
x-api-key: YOUR_API_KEY
Content-Type: application/json
Check Deployment Status
Send a GET request to the /api/v1/instances/{instance_id}/deployments/currentendpoint.
Header
curl Example
Response Example
Update an Instance
Send a PATCH request to the /api/v1/instances/{instance_id}/config endpoint with the config changes.
Headers
Body Example
curl Example
x-api-key: YOUR_API_KEY
Content-Type: application/json
Restart the instance by sending a POST request to the /api/v1/instances/{instance_id}/status:update endpoint with the action “RESTART”.
Headers
Body
curl Example
Response
x-api-key: YOUR_API_KEY
Content-Type: application/json
Stop an Instance
Send a POST request to the /api/v1/instances//status:update endpoint with the action “STOP”.
Important Note : Stopping an instance will result in all data being deleted. Ensure that you have backed up any necessary data before stopping the instance.
Header
Body
curl Example
Response
x-api-key: YOUR_API_KEY
Content-Type: application/json