REST API reference · Application definitions

Create an application definition from a complete config¶

Read and manage reusable application structures.

POST/application-definitions/

Parameters¶

Name	Location	Type	Required
`Idempotency-Key`	header	string	Yes

Request body¶

Send a body that matches the published schema.

View request schema

{
  "additionalProperties": false,
  "properties": {
    "config": {
      "$ref": "#/components/schemas/ApplicationDefinitionConfig"
    }
  },
  "required": [
    "config"
  ],
  "type": "object"
}

Request¶

curl --request POST \
  --url 'https://api.staging.levr.ai/api/external/v1/application-definitions/' \
  --header 'Authorization: Bearer $LEVR_API_TOKEN' \
  --header 'Idempotency-Key: $IDEMPOTENCY_KEY' \
  --header 'Content-Type: application/json' \
  --data '@request.json'

Responses¶

Status	Description
`201`	Created
`400`	Correct the request fields and try again.
`401`	Provide a valid portal API token and try again.
`403`	This portal API token does not allow the requested action.
`409`	The request conflicts with the resource's current state. Refresh it before trying again.
`422`	Correct the invalid values and try again.
`429`	Too many requests were sent. Wait before trying again.
`500`	Levr could not complete the request. Keep the request ID and retry when safe.