When I Work Timezones API

openapi: 3.2.0
info:
  version: 1.0.0
  title: When I Work API Documentation Timezones API
  description: The When I Work API is thorough, flexible, and restful.
servers:
- url: https://api.wheniwork.com
  description: Production
security:
- W-Token: []
tags:
- name: Timezones
  description: Timezones for When I work workplaces including Olson ID
paths:
  /2/timezones:
    get:
      summary: List Timezones
      description: Fetch a list of timezones
      tags:
      - Timezones
      responses:
        '200':
          description: Valid
          content:
            application/json:
              schema:
                type: object
                properties:
                  timezone:
                    type: array
                    items:
                      $ref: '#/components/schemas/Timezones'
      operationId: get2Timezones
      x-operation-id-source: derived
  /2/timezones/{id}:
    get:
      summary: Get Timezone
      description: Get a single timezone by ID
      tags:
      - Timezones
      parameters:
      - name: id
        in: path
        description: The ID of the timezone
        schema:
          type: integer
        required: true
      responses:
        '200':
          description: Valid
          content:
            application/json:
              schema:
                type: object
                properties:
                  time:
                    $ref: '#/components/schemas/Timezones'
      operationId: get2TimezonesById
      x-operation-id-source: derived
components:
  schemas:
    Timezones:
      type: object
      properties:
        timezone_id:
          example: 12
          type: integer
        timezone_name:
          example: Eastern Time (US/Detroit)
          type: string
        offset:
          example: -4
          type: integer
        olson_id:
          example: America/Detroit
          type: string
  securitySchemes:
    W-Token:
      type: http
      scheme: bearer
      bearerFormat: JSON Web Token
      description: "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 the username and password of a When I Work user. Your developer key can be used like the following in the headers.\n```\ncurl -X POST \\\n  https://api.login.wheniwork.com/login \\\n  -H 'W-Key: <INSERT_DEVELOPER_KEY_HERE>' \\\n  -H 'content-type: application/json' \\\n  -d '{\"email\":\"<INSERT_USERNAME_HERE>\",\"password\":\"<INSERT_PASSWORD_HERE>\"}'\n```\n\nAuthenticating returns back a person object containing a token that is used to authenticate all future requests. You can now use this token to fetch all the users tied to your person. The token may be included in the headers, as a cookie, or in the query string using the key ‘W-Token’ or ‘Authorization’. If the authenticated user belongs to more than one Workplace you will need to get the User listing to obtain the user-id value\n```\ncurl -X GET \\\n  'https://api.wheniwork.com/2/login?show_pending=true' \\\n  -H 'Host: api.wheniwork.com' \\\n  -H 'Authorization: Bearer <INSERT_TOKEN_HERE>'\n```\n\nThe response will also include a listing of the user objects related to the person for each associated When I Work account. You can use the user ID to set the context for which account you will be acting upon by providing a When I Work user ID through the ‘W-UserID’ header.\n```\ncurl -X GET \\\n  https://api.wheniwork.com/2/users \\\n  -H 'Authorization: Bearer <INSERT TOKEN HERE>' \\\n  -H 'W-UserId: <INSERT_USER_ID_HERE>'\n```\nWhen I Work protects our application and API with rate limiting thresholds. Rate limiting utilizes thresholds based on rolling windows of time. Typical responses will be 403 level client side errors when encountering these limits. If you suspect you are encountering one of our thresholds please connect with our Customer Care team at support@wheniwork.com.\n\nYou can find additional authentication related API documentation in our [Login Service API docs](https://apidocs.wheniwork.com/external/index.html?repo=login).\n"