Applications

Get your applications

GET /applications

Query string parameters

Response
Status code 200

{
  "data": [
    {
      "name": "My app",
      "client_id": "WEjjEgPTkTwOjjYzxIXguaRSbO2n5NESsxab34Y7",
      "client_secret": "q9ELWbCaNVlhUwHBWqRI9oMha9iQXcvkhcoqFxdk",
      "redirect_uri": "http://example.com",
      "created_at": "2015-11-02 12:23:02",
      "updated_at": "2015-11-02 12:23:02"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 0,
    "per_page": 15,
    "urls": {
      "previous": null,
      "next": null
    }
  }
}

Get an application

GET /applications/:application_client_id

Response
Status code 200

{
  "name": "My app",
  "client_id": "WEjjEgPTkTwOjjYzxIXguaRSbO2n5NESsxab34Y7",
  "client_secret": "q9ELWbCaNVlhUwHBWqRI9oMha9iQXcvkhcoqFxdk",
  "redirect_uri": "http://example.com",
  "created_at": "2015-11-02 12:23:02",
  "updated_at": "2015-11-02 12:23:02"
}

Create an application

POST /applications

You need a trusted client before you can use this endpoint.

Parameters

  • name string - Application name.
    • Required
    • Maximum 255 characters
  • redirect_uri string - Where to redirect when authenticating
    • Must be a valid URL
    • Maximum 255 characters

Payload

{
  "name": "Some application",
  "redirect_uri": "http://example.com"
}

Response
Status code 201

{
  "name": "Some application",
  "client_id": "7qmbVL8dFOZZqyZ3XqyBNakxVPnBVQcxuhTrjOSs",
  "client_secret": "vpnM4tjcELpYXBwmDnTQPzqWnW4G2jDpqIrTV75M",
  "redirect_uri": "http://example.com",
  "created_at": "2015-11-02 12:13:04",
  "updated_at": "2015-11-02 12:13:04"
}

Update an application

PUT /applications/:application_client_id

You need a trusted client before you can use this endpoint.

Parameters

  • name string - Application name.
    • Required
    • Maximum 255 characters
  • redirect_uri string - Where to redirect when authenticating
    • Must be a valid URL
    • Maximum 255 characters

Payload

{
  "name": "Some updated application",
  "redirect_uri": "http://example.com/v_234"
}

Response
Status code 200

{
  "name": "Some updated application",
  "client_id": "7qmbVL8dFOZZqyZ3XqyBNakxVPnBVQcxuhTrjOSs",
  "client_secret": "vpnM4tjcELpYXBwmDnTQPzqWnW4G2jDpqIrTV75M",
  "redirect_uri": "http://example.com/v_234",
  "created_at": "2015-11-02 12:13:04",
  "updated_at": "2015-11-02 12:15:23"
}

Delete an application

DELETE /applications/:application_client_id

Response
Status code 204