Skip to main content
Not a developer? Get general product support via our knowledge base.
The Ropes API lets you programmatically manage candidates, assessments, problems, results, and other resources in your Ropes organization. The API follows REST conventions, accepts JSON request bodies, and returns JSON responses. All production requests must use HTTPS.

​
Base URL

Send API requests to:
For example, the endpoint for listing candidates is:

​
Authentication

The Ropes API uses API keys for authentication. Include your API key in the x-api-key header with every request:
Keep API keys secure. Never expose them in client-side code, public repositories, browser requests, or application logs.

​
Create an API Key

You need permission to manage integrations for your Ropes organization.
  1. Sign in to your Ropes account.
  2. Open Settings.
  3. Under Integrations, select API.
  4. Click Generate New API Key.
  5. Optionally, enter a descriptive name such as Production API or Reporting Integration.
  6. Click Generate, then copy the key and store it securely.
Use separate API keys for different applications and environments. This makes individual integrations easier to identify and revoke. You can view and revoke API keys from Settings → Integrations → API. To revoke a key:
  1. Find the key you want to revoke.
  2. Open its actions menu.
  3. Select Delete API Key.
  4. Confirm the deletion.
Revocation takes effect immediately and cannot be undone. Update the affected integration with a replacement key before deleting a key that is currently in use.

​
Response Codes

Ropes uses standard HTTP status codes to indicate whether a request succeeded.