# Service users API

**URL:** https://heroiclabs.com/docs/heroic-cloud/api/service-users/
**Keywords:** service users, api, heroic cloud, endpoints
**Categories:** heroic-cloud, api, service-users

---


# Service users API

Every operation a [service user](../../access-control/#service-users) can call. Operations outside this set exist in the Heroic Cloud API but reject service user credentials with `403`.

Requests go to `https://cloud.heroiclabs.com` and authenticate with HTTP Basic, using `<service-user>@<organization>` as the username and the service user's secret as the password. For worked examples and error codes, see [Use the Heroic Cloud API](../use-the-api/).

{{< note "important" >}}
Responses serialize enums as numbers rather than the names listed here. A completed build returns `"status": 2`, not `"status": "OPERATION_STATUS_DONE"`. See [Read enum values](../use-the-api/#read-enum-values).
{{< /note >}}

<!-- This file is located on static/specs/-->
<!-- Regenerate with: go run ./tools/service_users_parser/gen_service_user_swagger.go -->
{{< swagger spec="specs/heroic-cloud-service-users.json" hide_models="true" >}}