# BLNG User API

**Canonical:** https://apis.io/apis/blng/blng-user-api/  
**Provider:** Blng — https://apis.io/providers/blng/  
**Base URL:** https://users.blng.ai  
**Documentation:** https://users.blng.ai/

BLNG User API is one of 14 APIs that [Blng](https://apis.io/providers/blng/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Workspaces, User, Organization, Subscription, and SSO. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

REST API that manages BLNG users, roles and permissions, workspaces and workspace members, workspace and subscription invitations, organizations, SSO configuration, marketing consent, tooltips, and user subscriptions. Also exposes composite operations that create an organization, subscription and user in a single call. Authenticated with AWS Cognito user tokens, plus a client-credentials machine token for the billing integration.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/users/{userId}` | get user |
| PUT | `/users/{userId}` | Update user |
| GET | `/users/{userId}/marketing-consent` | Get marketing consent state and whether the one-time prompt is due |
| PUT | `/users/{userId}/marketing-consent` | Record a marketing consent choice, or that the prompt was dismissed |
| POST | `/composite/createOrgAndSubscriptionWithUser` | Creates an organization, a subscription, and a user, and attaches them in one transaction |
| POST | `/composite/createUserAndSubscription` | Creates a user, a subscription, and attaches them in one transaction. Subscription type is starter. |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/blng/refs/heads/main/openapi/blng-user-api-openapi.yml
- **APIReference** — https://users.blng.ai/
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/blng/refs/heads/main/overlays/blng-user-api-overlay.yaml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/blng/refs/heads/main/apis.yml

## Other Blng APIs (12)

- [BLNG Billing API](https://apis.io/apis/blng/blng-billing-api/)
- [Blng Chat Prompts API](https://apis.io/apis/blng/blng-chat-prompts-api/)
- [Blng Composite API](https://apis.io/apis/blng/blng-composite-api/)
- [Blng Design Journey API](https://apis.io/apis/blng/blng-design-journey-api/)
- [Blng Invitation API](https://apis.io/apis/blng/blng-invitation-api/)
- [Blng Journeys API](https://apis.io/apis/blng/blng-journeys-api/)
- [Blng Organization API](https://apis.io/apis/blng/blng-organization-api/)
- [Blng Prompts API](https://apis.io/apis/blng/blng-prompts-api/)
- [Blng Subscription API](https://apis.io/apis/blng/blng-subscription-api/)
- [Blng User Subscription API](https://apis.io/apis/blng/blng-user-subscription-api/)
- [Blng User Tooltip API](https://apis.io/apis/blng/blng-user-tooltip-api/)
- [Blng Webhook API](https://apis.io/apis/blng/blng-webhook-api/)

## Tags

Workspaces, User, Organization, Subscription, SSO

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/blng/blng-user-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/blng/.