---
title: "Create endpoint"
method: POST
path: "/dashboard/endpoints"
tags: ["Endpoint"]
---

# Create endpoint

`POST /dashboard/endpoints`

## Request

- Base URL: `https://blockreq.com/api`
- URL: `https://blockreq.com/api/dashboard/endpoints`
- Auth: HTTP bearer

## Request body

- object
  - `chain` string, required
  - `name` string
  - `teamId` string, uuid
  - `keyMode` 'shared' | 'dedicated'

## Response `200`

Created endpoint

- object
  - `code` number, required
  - `ok` boolean, required
  - `data` object, required
    - `createdEndpoint` object, required
      - `endpointId` string, required
      - `apiKey` string, required
      - `keyId` string, required
      - `keyPrefix` string, nullable, required
      - `credentialLastFour` string, nullable, required
      - `keyDigestVersion` 'blockreq-rpc-key-v1' | 'legacy-sha256-raw-v1', required
      - `keyMode` 'shared' | 'dedicated', required
      - `keyStatus` 'active' | 'revoked', required
      - `keyVersion` number, required
      - `keyCreatedAt` string, required
      - `keyRotatedAt` string, nullable, required
      - `keyRevokedAt` string, nullable, required
      - `credential` string, nullable, required
      - `affectedEndpointIds` string[], required
      - `creationOutcome` 'created' | 'reused_existing', required
      - `endpoint` string, required
      - `chain` string, required
      - `httpsUrl` string, required
      - `wssUrl` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Account suspended, or Free active-chain entitlement exceeded
- `500`: Internal Error

---

[API](https://skmtc.dev/blockreq/apis/blockreq-public-api.md) · [All operations](https://skmtc.dev/blockreq/apis/blockreq-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockreq/apis/blockreq-public-api/revisions/f433235ab9af?raw)