NUnullplatform
Application

Create an application

Changed on

Creates a new application in an existing namespace.

post/application

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/application
  • Auth
    HTTP bearer

Request body

namestring required

The application name.

namespace_idinteger required

The ID of the namespace that owns this application.

repository_urlstring required

The URL of the repository that holds this application.

repository_app_pathstring nullable

The folder where the application is located inside a monorepo.

template_idinteger

The ID of the template that was used to create this application.

auto_deploy_on_creationboolean

True if the application must be deployed immediately after being created, false otherwise.

Example request

{
  "name": "Billing API",
  "namespace_id": 1234,
  "repository_url": "https://github.com/crypto-inc/accounting-billing-api",
  "template_id": 2345,
  "settings": {
    "defaults": {
      "branch": "main",
      "environment": "staging"
    },
    "asset": {
      "docker_server": {
        "uri": "registry.example.com/acme-corp/billing-api"
      },
      "ecr": {
        "uri": "123456789012.dkr.ecr.us-east-1.amazonaws.com/billing-api",
        "arn": "arn:aws:ecr:us-east-1:123456789012:repository/billing-api"
      }
    },
    "code_repository": {
      "specification_id": "7f3c910e-8138-4d65-9d09-b97d89f2c509",
      "specification_slug": "github-configuration",
      "specification_name": "GitHub",
      "specification_icon": "github",
      "provider_id": "82eee42c-46c9-4bb7-a53d-c08b027817f3"
    }
  }
}

Response

The operation was successful.

idinteger required

A system-wide unique ID for the application. Assigned by nullplatform.

nrnstring

The NRN (Nullplatform Resource Name) uniquely identifying this application in the nullplatform hierarchy. Built by nullplatform from the entity hierarchy.

namestring required

The application name.

slugstring required

A namespace-wide unique slug for the application. nullplatform derives it from the name when the application is created: you can't send it, and it never changes afterwards.

namespace_idinteger required

The ID of the namespace that owns this application.

status'pending' | 'creating' | 'updating' | 'active' | 'inactive' | 'failed' | 'deleting' required

The status of the application.

repository_urlstring required

The URL of the repository that holds this application.

repository_app_pathstring nullable

The folder where the application is located inside a monorepo.

is_mono_repoboolean required

True if the application shares the repository with other apps, false otherwise.

auto_deploy_on_creationboolean required

True if the application must be deployed immediately after being created, false otherwise.

template_idinteger required

The ID of the template used to create this application.

Example response

{
  "id": 1234,
  "nrn": "organization=1:account=2:namespace=3:application=4",
  "name": "Billing API",
  "slug": "billing-api",
  "namespace_id": 2345,
  "status": "active",
  "repository_url": "https://github.com/crypto-inc/accounting-billing-api",
  "template_id": 3456,
  "metadata": {
    "key": "value"
  },
  "settings": {
    "defaults": {
      "branch": "main",
      "environment": "staging"
    },
    "asset": {
      "docker_server": {
        "uri": "registry.example.com/acme-corp/billing-api"
      },
      "ecr": {
        "uri": "123456789012.dkr.ecr.us-east-1.amazonaws.com/billing-api",
        "arn": "arn:aws:ecr:us-east-1:123456789012:repository/billing-api"
      }
    },
    "code_repository": {
      "specification_id": "7f3c910e-8138-4d65-9d09-b97d89f2c509",
      "specification_slug": "github-configuration",
      "specification_name": "GitHub",
      "specification_icon": "github",
      "provider_id": "82eee42c-46c9-4bb7-a53d-c08b027817f3"
    }
  }
}

Changes

  • 728d4df70ca1Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 730fb95f21b8Revision changes
    • info

      the response optional property became read-only for the status

    • info

      the response required property became read-only for the status

    • info

      the response required property became read-only for the status