Accounts

List of valid attributes:

Attribute	Description	Specifics
created_at	Timestamp of creation	Cannot be set
discarded_at	Null or timestamp of removal	Cannot be set
name	Name of the account	-
timezone	The identifier of the time zone in which time zone-dependent calculations are made	string, can only be updated; supported values can be retrieved using the supported time zones endpoint

Meta data: Permissions

Group	Description
account_membership	Contains permissions if account memberships can be managed
offboarding	Permissions if offboardings can be viewed, created or edited
onboarding	Permissions if onboardings can be viewed, created or edited
users	Permissions if users in account can be viewed or created

Show

Example response:

{
  "data": {
    "id": "98815bd8-f3e6-41ec-8c4a-25a431ac6ce4",
    "type": "account",
    "attributes": {
      ...
    }
  }
}

This endpoint returns a specific account.

HTTP Request

GET /api/v1/accounts/:account_id

URL Parameters

Parameter	Description
account_id	The ID of the account to retrieve

Create

Example request:

{
  "data": {
    "type": "account",
    "attributes": {
      "name": "New Account",
      "terms": {
        "accepted": true
      }
    }
  }
}

Example response:

{
  "data": {
    "id": "f4db9b2a-386e-4e17-9f04-b28c68048b34",
    "type": "identity",
    "attributes": {
      ...
    }
  }
}

This endpoint creates a new account for the currently logged in user.

HTTP Request

POST /api/v1/accounts

Arguments

Parameter	Description
name	Account name
terms.accepted	Must be true

Update

Example request:

{
  "data": {
    "type": "account",
    "attributes": {
      "name": "New Name",
      "timezone": "Europe/Berlin"
    }
  }
}

Example response:

{
  "data": {
    "id": "98815bd8-f3e6-41ec-8c4a-25a431ac6ce4",
    "type": "account",
    "attributes": {
      ...
    }
  }
}

This endpoint updates a specific account.

HTTP Request

PUT /api/v1/accounts/:account_id

URL Parameters

Parameter	Description
account_id	The ID of the account to update

Destroy

Example response:

{
  "data": {
    "id": "98815bd8-f3e6-41ec-8c4a-25a431ac6ce4",
    "type": "account",
    "attributes": {
      ...
    }
  }
}

This endpoint deletes a specific account.

After this action, nobody will be able to log into and use the account anymore.

HTTP Request

DELETE /api/v1/accounts/:account_id

URL Parameters

Parameter	Description
account_id	The ID of the account to destroy

List Supported Time Zones

Example response:

{
  "data": [
    {
      "id": "Europe/Berlin",
      "type": "supported_time_zone",
      "attributes": {
        "identifier": "Europe/Berlin"
      }
    }
  ]
}

This endpoint returns the time zones that are currently supported by the application.

HTTP Request

GET /public/v1/supported_time_zones