User Info

The user info endpoint returns your account details and the teams you belong to. This is useful for discovering your team IDs, which you'll need when creating monitors or status pages.

Example request:

$ OHDEAR_TOKEN="your API token"
$ curl https://ohdear.app/api/me \
    -H "Authorization: Bearer $OHDEAR_TOKEN" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json'

All endpoints below follow the same authentication pattern.

Get your user info #

GET /api/me

Returns your account details and team memberships.

Here's what the response looks like:

{
  "id": 1,
  "name": "Firstname Lastname",
  "email": "[email protected]",
  "photo_url": "https://www.gravatar.com/avatar/...jpg",
  "teams": [
    {
      "id": 1,
      "name": "Your Team Name",
      "timezone": "Europe/Brussels",
      "created_at": "2018-01-01T00:00:00.000000Z"
    }
  ],
  "capabilities": {
    "full_access": false,
    "monitor_ids": [1, 2],
    "status_page_ids": [3]
  }
}

• id: the identifier of the user this API key belongs to
• name, email, photo_url: personal information about your account
• teams: an array of teams this user belongs to. A user can be a member of several teams. Each team includes:
  • id: team ID, used throughout the API when creating monitors or status pages
  • name: human-readable team name
  • timezone: the team's timezone
  • created_at: when the team was created (UTC)
• capabilities: describes what this API token can access
  • full_access: true if the token has unrestricted access to the entire API, false if it is scoped to specific resources
  • monitor_ids: when full_access is false, lists the monitor IDs this token can access. Empty array when full_access is true.
  • status_page_ids: when full_access is false, lists the status page IDs this token can access. Empty array when full_access is true.