Skip to main content

Akoya
Documentation

Create App

POST

sandbox-api.akoya.com/manage/{version}/apps/register

Creates an application. This endpoint will automatically subscribe the created app to all valid providers.

⚠️ scope must include at least one product in addition to Account Information.

  • client_name should be alphanumeric and may include special characters: #$&'()\*+,-./|-é.. client_name needs to be unique. You cannot create two applications with the same client_name.

  • logo_uri must be a URL to a file (Required).

    • Minimum height: 200px

    • Minimum width: 200px

    • Maximum height: 1024px

    • Maximum width: 1024px

    • File types: transparent PNG or JPG

    • Maximum file size: 2 MB

  • icon_uri must be a URL to a file (Optional).

    • Must be square.

    • Height = width.

    • Minimum height: 40px

    • Minimum width: 40px

    • Maximum height: 200px

    • Maximum width: 200px

    • File types: transparent PNG or JPG

    • Maximum file size: 2 MB

  • scope: Products this app will use. This product list needs to be provided as a string where the products are space-seperated. You should include at least one product in addition to Account Information.


Path Parameters

  1. version*

    string

    Management API major version (e.g. v2)

Body Params

  1. client_name*

    string

  2. description*

    string

  3. redirect_uris*

    array

  4. logo_uri*

    string

  5. icon_url

    string

  6. contacts*

    array

  7. client_uri*

    string

  8. scope*

    string


Responses

  1. 200

    OK

    Response Body

      client_id

      string

      client_secret

      string

      client_name

      string

      redirect_uris

      array of strings

        string

      client_uri

      string

      contacts

      array of strings

        string

      description

      string

      logo_uri

      string

      icon_url

      string

      scope

      string

      grant_types

      array of strings

        string

      status

      string

    Headers

    1. Content-Typestring

    2. X-Akoya-Interaction-Idstring

  2. 400

    Invalid Argument

    Response Body

      code

      string

      message

      string

    Headers

    1. Content-Typestring

    2. X-Akoya-Interaction-Idstring

  3. 409

    Already Exists

    Response Body

      code

      string

      message

      string

    Headers

    1. Content-Typestring

    2. X-Akoya-Interaction-Idstring

CTRL + K

Try it

Authorization

const options = {
	"method": "POST",
	"headers": {
		"accept": "application/json"
	},
	"body": JSON.stringify({
	"client_name": "",
	"description": "",
	"redirect_uris": "",
	"logo_uri": "",
	"contacts": "",
	"client_uri": "",
	"scope": ""
})
}};
fetch('sandbox-api.akoya.com/manage//apps/register', options)
  .then(response => response.json())
  .catch(err => console.error(err));