Endpoints

List endpoints

get

List the calling team's endpoints. Deleted endpoints are never returned.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Responses

200

OK

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get/endpoints

HTTPcURLJavaScriptPython

GET /admin/v1/endpoints HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "endpoints": [
    {
      "api_key": "text",
      "chain": "text",
      "enabled": true,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "network": "text",
      "urls": {
        "https": "text",
        "wss": "text"
      }
    }
  ]
}

Create an endpoint

post

Mint a new RPC endpoint for the calling team. Subject to the per-team endpoint limit and the team's CU-quota gating (an over-quota team's endpoint is created disabled).

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Body

application/json

Endpoint to create

chainstringOptional

namestringOptional

networkstringOptional

Responses

201

Created

application/json

api_keystringOptional

chainstringOptional

enabledbooleanOptional

idstring · uuidOptional

namestringOptional

networkstringOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

409

Conflict

application/json

500

Internal Server Error

application/json

post/endpoints

HTTPcURLJavaScriptPython

POST /admin/v1/endpoints HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "chain": "text",
  "name": "text",
  "network": "text"
}

{
  "api_key": "text",
  "chain": "text",
  "enabled": true,
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "network": "text",
  "urls": {
    "https": "text",
    "wss": "text"
  }
}

Get an endpoint

get

Fetch a single endpoint owned by the calling team. An endpoint owned by another team or one that has been deleted returns 404, indistinguishable from one that never existed.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Path parameters

idstring · uuidRequired

Endpoint UUID

Responses

200

OK

application/json

api_keystringOptional

chainstringOptional

enabledbooleanOptional

idstring · uuidOptional

namestringOptional

networkstringOptional

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get/endpoints/{id}

HTTPcURLJavaScriptPython

GET /admin/v1/endpoints/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "api_key": "text",
  "chain": "text",
  "enabled": true,
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "network": "text",
  "urls": {
    "https": "text",
    "wss": "text"
  }
}

Delete an endpoint

delete

Soft-delete the endpoint. After deletion it is invisible: subsequent gets return 404 and it never reappears in list.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Path parameters

idstring · uuidRequired

Endpoint UUID

Responses

204

No Content

No content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete/endpoints/{id}

HTTPcURLJavaScriptPython

DELETE /admin/v1/endpoints/{id} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

No content

Disable an endpoint

post

Set the endpoint disabled. Idempotent — disabling an already-disabled endpoint is a no-op success.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Path parameters

idstring · uuidRequired

Endpoint UUID

Responses

200

OK

application/json

api_keystringOptional

chainstringOptional

enabledbooleanOptional

idstring · uuidOptional

namestringOptional

networkstringOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post/endpoints/{id}/disable

HTTPcURLJavaScriptPython

POST /admin/v1/endpoints/{id}/disable HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "api_key": "text",
  "chain": "text",
  "enabled": true,
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "network": "text",
  "urls": {
    "https": "text",
    "wss": "text"
  }
}

Enable an endpoint

post

Set the endpoint enabled. Idempotent — enabling an already-enabled endpoint is a no-op success.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Path parameters

idstring · uuidRequired

Endpoint UUID

Responses

200

OK

application/json

api_keystringOptional

chainstringOptional

enabledbooleanOptional

idstring · uuidOptional

namestringOptional

networkstringOptional

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post/endpoints/{id}/enable

HTTPcURLJavaScriptPython

POST /admin/v1/endpoints/{id}/enable HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "api_key": "text",
  "chain": "text",
  "enabled": true,
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "network": "text",
  "urls": {
    "https": "text",
    "wss": "text"
  }
}