API: Invites

This Developer API lets you list, accept, or reject invites. If you want to invite a new user to your app, please check this API. All endpoints require authentication with an API token.

List Invites

Lists all app invites for the logged user.

GET /api/2/invites

Example:

curl \
  -H "X-HockeyAppToken: 4567abcd8901ef234567abcd8901ef23" \
  https://rink.hockeyapp.net/api/2/invites

Response:

Status: 200
Body:
{
    "apps": [
        {
            "company": "Codenauts UG",
            "public_identifier": "0873e2b98ad046a92c170a243a8515f6",
            "title": "HockeyApp",
            "role": 3,
            "bundle_identifier": "de.codenauts.hockeyapp",
            "status": 2,
            "release_type": 0,
            "owner": "Thomas Dohmke",
            "platform": "Android"
        }
    ],
    "status": "success"
}

The field role is defined as follows:

  • 0 for owner
  • 1 for developer
  • 2 for member
  • 3 for tester

The field public_identifier equals the App ID and should be used to accept or reject the invite.

Accept Invite

Accept an invite.

POST /api/2/invites/APP_ID

Example:

curl \
  -X POST \
  -H "X-HockeyAppToken: 4567abcd8901ef234567abcd8901ef23" \
  https://rink.hockeyapp.net/api/2/invites/0873e2b98ad046a92c170a243a8515f6

Response

Status: 201

Reject Invite

Reject an invite. Note that there is no undo; once you reject an invitation, you need to ask the developer to invite you again.

DELETE /api/2/invites/APP_ID

Example:

curl \
  -X DELETE \
  -H "X-HockeyAppToken: 4567abcd8901ef234567abcd8901ef23" \
  https://rink.hockeyapp.net/api/2/invites/0873e2b98ad046a92c170a243a8515f6

Response:

Status: 200