The Speedyrails Manager provides a RESTful Application Program Interface (API) that allows you to manage aspects of your organization. To access your organization's API tokens, select API Tokens from the User Profile menu.

HTTP Methods

The Speedyrails API accepts the following HTTP methods:

Generating an API Token

All API calls require an API Token used as a bearer token to authenticate with Speedyrails. If an API token is not included in the API call header, the call will return a 401 Unauthorized error.

To Generate an API token:

1. From the Speedyrails Manager, click your User name.
2. Click API Tokens.
3. Click Add API Token.
4. Enter a Label for the API token.
5. Select the organization from the drop-down menu.
6. Select the Permissions for the API token.
7. Click Generate API Token. 

Once you have created an API token, it will be visible on your screen to allow you to copy and paste it somewhere safe. After leaving that screen, the API token will never be visible in the Speedyrails Manager again.

Interpreting Examples

Each API call includes an example call and an example curl request. Any capitalized terms, such as API_TOKEN, or LABEL_NAME show where to include your own API Token, or label.

Response Codes

Once you make an API request, the server will respond with a response code depending on the result.

200 OK

The API request completed successfully.

201 Scheduled

The API request completed successfully, and created a new resource.

204 No Content

The API request completed successfully, but did not return any data.

400 Bad Request

The API request is invalid or cannot be completed.

401 Unauthorized

The request is correct but cannot complete because the token is not included or is incorrect.

403 Forbidden

The request is correct but cannot complete because of the token's permission level.

404 Not Found

The requested URL does not exist, or is incorrect.

422 Unprocessable Entity

The sent parameters contain an error and the request cannot complete the request.

500 Internal Server Error

An error occurred when processing your request.
Try your request again, or contact Speedyrails Support.

503 Service Unavailable

The request cannot process because the server is unavailable.
Try your request again, or contact Speedyrails Support