Skip to main content

Base URL

The Skald API is built on REST principles. We enforce HTTPS in every request to improve data security, integrity, and privacy. The API does not support HTTP. All requests contain the following base URL:
https://api.useskald.com

Authentication

Each Project inside an Organization on Skald have it’s own API key. It follows the format: sk_proj_xxxxxxxxxxxxxxxxxxxxxxx To authenticate you need to add an Authorization header with the contents of the header being Bearer sk_proj_xxxxxxxxx where sk_proj_xxxxxxxxx is your project API Key.
Authorization: Bearer sk_proj_xxxxxxxxx

Response codes

Skald uses standard HTTP codes to indicate the success or failure of your requests. In general, 2xx HTTP codes correspond to success, 4xx codes are for user-related failures, and 5xx codes are for infrastructure issues.
StatusDescription
200Successful request.
400Check that the parameters were correct.
401The API key used was missing.
403The API key used was invalid.
404The resource was not found.
429The rate limit was exceeded.
I