Create Application

POST /auth/apps

Create a new application in the caller's org. This is the default application type and should be used for most customer applications.

• User action signature required. See User Action Signing for more information.

• Request headers required. See Request Headers for more information.

• Authentication required. See Authentication Headers for more information.

Required Permissions

Name	Conditions
Auth:Apps:Create	Always Required
Auth:Types:Application	Always Required

Request Body

name *	String	the name of the application, must be unique within the caller's org
relyingPartyId *	String	the top level domain where the application will be hosted, for example: dfns.io
origin *	String	the url of the application, for example: https://api.dfns.io
kind *	String	the kind of application being created, must be ClientSideApplication (Note: This can be used client or server side so disregard naming)
permissionId	String	Optional ID of the permission that will be assigned to the application. If no permission ID is given, the application will be assigned the same permissions as the caller
externalId	String	Optional user defined value that can be used to correlate the entity with an external system

Example:

{
  "name": "MyApp Production",
  "relyingPartyId": "https://myapp.example.co",
  "origin": "example.co",
  "kind": "ClientSideApplication",
  "permissionId": "pm-delaw-avoca-v16r37fpp8koqebc"
}

Responses

• See Common Errors for common errors.

• See Application Management Errors for application management specific errors.

200

Success - The newly created application

{
  "appId": "ap-24vwa-92s32-8tvqi1dg0a95megt",
  "kind": "ClientSideApplication",
  "orgId": "or-yanke-mars-6ulofamogg8fs87v",
  "expectedRpId": "localhost",
  "expectedOrigin": "http://localhost:5500/",
  "name": "LocalClient",
  "isActive": true,
  "permissionAssignments": [
    {
      "permissionId": "pm-paris-lithi-17bf4ef01h3aj6h4",
      "permissionName": "AppManager",
      "assignmentId": "",
      "operations": [
        "Auth:Apps:Create",
        "Auth:Apps:Read",
        "Auth:Apps:Update",
      ]
    }
  ],
  "accessTokens": []
}