public
Application

Add a new Application to an Organization

Changed on

Creates a new Application, then adds it to the specified Organization.

post/orgs/{orgId}/apps

Request

  • Base URL
    https://api.humanitec.io
  • URL
    https://api.humanitec.io/orgs/{orgId}/apps
  • Auth
    none declared

Path parameters

orgIdstring required

The Organization ID.

Request body

idstring required

The ID which refers to a specific application.

namestring required

The Human-friendly name for the Application.

skip_environment_creationboolean

If true, no environment will be created with the application.

Response

The Application requested.

created_atstring required

The timestamp in UTC indicates when the Application was created.

created_bystring required

The user who created the Application.

idstring required

The ID which refers to a specific application.

namestring required

The Human-friendly name for the Application.

org_idstring required

The Organization id of this Application

status'active' | 'deleting' required

The status of the application

status_changed_atstring date-time required

The timestamp in UTC of when the Environment status was last changed.

status_messagestring

The message associated with the status of the environment

Example response

{
  "created_at": "2020-05-22T14:53:27Z",
  "created_by": "a.user@example.com",
  "status": "active",
  "status_changed_at": "2020-05-22T14:53:27Z",
  "envs": [
    {
      "id": "my-env",
      "name": "My Environment"
    }
  ],
  "id": "my-app",
  "name": "My Application"
}

Changes

  • 4db6186594e3Revision changes
    • info

      added the new optional request property

    • info

      added the optional 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