Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

When I Work Accounts API

Accounts (aka Workplaces) are objects that define a business account with When I Work. Each user is associated with an account enabling them to access Shifts or other data.For more information about Accounts, visit the [Help Center](https://help.wheniwork.com/article-categories/account-settings/).

When I Work Accounts API is one of 22 APIs that When I Work publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Accounts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, and 8 JSON Schemas.

This API exposes 5 operations across 4 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://api.wheniwork.com.

5 operations 4 paths 3 schemas 2 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.wheniwork.com/2
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

When I Work Accounts API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JSON Web Token) (W-Token). By default, every request must be authenticated.

  • W-Token — Authentication with When I Work is based on a token model using [JSON Web Tokens](https://jwt.io/). First, you authenticate using a private developer key and t…

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 2 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Accounts 5

Accounts (aka Workplaces) are objects that define a business account with When I Work. Each user is associated with an account enabling them to access Shifts or other data. For mo…

GET
/2/account
Get Account
→ 200
POST
/2/account
Create Account
body → 200
PUT
/2/account/{id}
Update Account
1 param body → 200
POST
/2/account/settings
Update Account Settings
body → 200
GET
/2/account/{id}/admins
List Admins
1 param → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are components-schemas-User (28 properties), schemas-Account (16 properties), schemas-Place (6 properties). Each schema is shown below with its type and property counts.

schemas-Place
object
6 properties
schemas-Account
object
16 properties
components-schemas-User
object
28 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

when-i-work-accounts-api-openapi.yml Raw ↑

Other APIs When I Work publishes across the network.

When I Work Annotations API
When I Work Availabilities API
When I Work Import API
When I Work OpenShift Requests API
When I Work Payrolls API
When I Work Positions API
When I Work Punch API
When I Work Request Type API
When I Work Schedule Templates API
When I Work Schedules (Locations) API
When I Work Shift Break - Paid Rest API
When I Work Shift Breaks API