Jump to

• Request
• Response

Create an Application

post

/api/v2/applications/

Make a POST request to this resource with the following application fields to create a new application:

• name: Name of this application. (string, required)

• description: Optional description of this application. (string, default="")

• client_type: Set to Public or Confidential depending on how secure the client device is. (choice, required)

  • confidential: Confidential
  • public: Public
• redirect_uris: Allowed URIs list, space separated (string, default="")
• authorization_grant_type: The Grant type the user must use for acquire tokens for this application. (choice, required)
  • authorization-code: Authorization code
  • password: Resource owner password-based
• skip_authorization: Set True to skip authorization step for completely trusted applications. (boolean, default=False)
• organization: Organization containing this application. (id, required)

Request

Supported Media Types

• application/json

Body ()

Root Schema : OAuth2Application

Type: object

Show Source

• authorization_grant_type(required): string
  Title: Authorization Grant Type

  Allowed Values: [ "authorization-code", "password" ]

  The Grant type the user must use for acquire tokens for this application.
• client_id: string
  Title: Client id

  Read Only: true

  Minimum Length: 1
• client_secret: string
  Title: Client Secret

  Read Only: true

  Minimum Length: 1

  Used for more stringent verification of access to an application when creating a token.
• client_type(required): string
  Title: Client Type

  Allowed Values: [ "confidential", "public" ]

  Set to Public or Confidential depending on how secure the client device is.
• created: string
  Title: Created

  Read Only: true
• description: string
  Title: Description
• id: integer
  Title: Id

  Read Only: true
• modified: string
  Title: Modified

  Read Only: true
• name(required): string
  Title: Name

  Maximum Length: 255
• organization(required): integer
  Title: Organization

  Organization containing this application.
• redirect_uris: string
  Title: Redirect URIs

  Allowed URIs list, space separated
• related: string
  Title: Related

  Read Only: true
• skip_authorization: boolean
  Title: Skip Authorization

  Set True to skip authorization step for completely trusted applications.
• summary_fields: string
  Title: Summary fields

  Read Only: true
• type: string
  Title: Type

  Read Only: true
• url: string
  Title: Url

  Read Only: true

{
    "properties":{
        "authorization_grant_type":{
            "description":"The Grant type the user must use for acquire tokens for this application.",
            "enum":[
                "authorization-code",
                "password"
            ],
            "title":"Authorization Grant Type",
            "type":"string",
            "x-nullable":true
        },
        "client_id":{
            "minLength":"1",
            "readOnly":true,
            "title":"Client id",
            "type":"string",
            "x-nullable":true
        },
        "client_secret":{
            "description":"Used for more stringent verification of access to an application when creating a token.",
            "minLength":"1",
            "readOnly":true,
            "title":"Client Secret",
            "type":"string",
            "x-nullable":true
        },
        "client_type":{
            "description":"Set to Public or Confidential depending on how secure the client device is.",
            "enum":[
                "confidential",
                "public"
            ],
            "title":"Client Type",
            "type":"string",
            "x-nullable":true
        },
        "created":{
            "readOnly":true,
            "title":"Created",
            "type":"string"
        },
        "description":{
            "title":"Description",
            "type":"string",
            "x-nullable":true
        },
        "id":{
            "readOnly":true,
            "title":"Id",
            "type":"integer"
        },
        "modified":{
            "readOnly":true,
            "title":"Modified",
            "type":"string"
        },
        "name":{
            "maxLength":"255",
            "title":"Name",
            "type":"string",
            "x-nullable":true
        },
        "organization":{
            "description":"Organization containing this application.",
            "title":"Organization",
            "type":"integer"
        },
        "redirect_uris":{
            "description":"Allowed URIs list, space separated",
            "title":"Redirect URIs",
            "type":"string",
            "x-nullable":true
        },
        "related":{
            "readOnly":true,
            "title":"Related",
            "type":"string"
        },
        "skip_authorization":{
            "description":"Set True to skip authorization step for completely trusted applications.",
            "title":"Skip Authorization",
            "type":"boolean",
            "x-nullable":true
        },
        "summary_fields":{
            "readOnly":true,
            "title":"Summary fields",
            "type":"string"
        },
        "type":{
            "readOnly":true,
            "title":"Type",
            "type":"string"
        },
        "url":{
            "readOnly":true,
            "title":"Url",
            "type":"string"
        }
    },
    "required":[
        "name",
        "client_type",
        "authorization_grant_type",
        "organization"
    ],
    "type":"object"
}

Back to Top

Response

Supported Media Types

• application/json

201 Response

Body ()

Root Schema : OAuth2Application

Type: object

Show Source

• authorization_grant_type(required): string
  Title: Authorization Grant Type

  Allowed Values: [ "authorization-code", "password" ]

  The Grant type the user must use for acquire tokens for this application.
• client_id: string
  Title: Client id

  Read Only: true

  Minimum Length: 1
• client_secret: string
  Title: Client Secret

  Read Only: true

  Minimum Length: 1

  Used for more stringent verification of access to an application when creating a token.
• client_type(required): string
  Title: Client Type

  Allowed Values: [ "confidential", "public" ]

  Set to Public or Confidential depending on how secure the client device is.
• created: string
  Title: Created

  Read Only: true
• description: string
  Title: Description
• id: integer
  Title: Id

  Read Only: true
• modified: string
  Title: Modified

  Read Only: true
• name(required): string
  Title: Name

  Maximum Length: 255
• organization(required): integer
  Title: Organization

  Organization containing this application.
• redirect_uris: string
  Title: Redirect URIs

  Allowed URIs list, space separated
• related: string
  Title: Related

  Read Only: true
• skip_authorization: boolean
  Title: Skip Authorization

  Set True to skip authorization step for completely trusted applications.
• summary_fields: string
  Title: Summary fields

  Read Only: true
• type: string
  Title: Type

  Read Only: true
• url: string
  Title: Url

  Read Only: true

{
    "properties":{
        "authorization_grant_type":{
            "description":"The Grant type the user must use for acquire tokens for this application.",
            "enum":[
                "authorization-code",
                "password"
            ],
            "title":"Authorization Grant Type",
            "type":"string",
            "x-nullable":true
        },
        "client_id":{
            "minLength":"1",
            "readOnly":true,
            "title":"Client id",
            "type":"string",
            "x-nullable":true
        },
        "client_secret":{
            "description":"Used for more stringent verification of access to an application when creating a token.",
            "minLength":"1",
            "readOnly":true,
            "title":"Client Secret",
            "type":"string",
            "x-nullable":true
        },
        "client_type":{
            "description":"Set to Public or Confidential depending on how secure the client device is.",
            "enum":[
                "confidential",
                "public"
            ],
            "title":"Client Type",
            "type":"string",
            "x-nullable":true
        },
        "created":{
            "readOnly":true,
            "title":"Created",
            "type":"string"
        },
        "description":{
            "title":"Description",
            "type":"string",
            "x-nullable":true
        },
        "id":{
            "readOnly":true,
            "title":"Id",
            "type":"integer"
        },
        "modified":{
            "readOnly":true,
            "title":"Modified",
            "type":"string"
        },
        "name":{
            "maxLength":"255",
            "title":"Name",
            "type":"string",
            "x-nullable":true
        },
        "organization":{
            "description":"Organization containing this application.",
            "title":"Organization",
            "type":"integer"
        },
        "redirect_uris":{
            "description":"Allowed URIs list, space separated",
            "title":"Redirect URIs",
            "type":"string",
            "x-nullable":true
        },
        "related":{
            "readOnly":true,
            "title":"Related",
            "type":"string"
        },
        "skip_authorization":{
            "description":"Set True to skip authorization step for completely trusted applications.",
            "title":"Skip Authorization",
            "type":"boolean",
            "x-nullable":true
        },
        "summary_fields":{
            "readOnly":true,
            "title":"Summary fields",
            "type":"string"
        },
        "type":{
            "readOnly":true,
            "title":"Type",
            "type":"string"
        },
        "url":{
            "readOnly":true,
            "title":"Url",
            "type":"string"
        }
    },
    "required":[
        "name",
        "client_type",
        "authorization_grant_type",
        "organization"
    ],
    "type":"object"
}

Back to Top