API Authentication¶
The JengaStack REST API uses bearer token authentication for all management operations.
Generating an API Token¶
- Log in to your JengaStack dashboard at https://jengastack.app.
- Navigate to Account Settings > Developer API.
- Click Generate New Token.
- Give your token a label (e.g.
ci-deployment-key) and assign required scopes. - Copy the generated secret token.
Authorization Header¶
Include the token in all HTTP request headers:
Error Responses¶
| HTTP Status | Error Code | Description |
|---|---|---|
401 Unauthorized |
ERR_AUTH_MISSING |
No Authorization header provided. |
401 Unauthorized |
ERR_TOKEN_INVALID |
Token has expired or was revoked. |
403 Forbidden |
ERR_INSUFFICIENT_SCOPE |
Token does not have permission for this resource. |