Jobs - Start

Service:

Azure Container Apps

API Version:

2026-07-01

Start a Container Apps Job

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/jobs/{jobName}/start?api-version=2026-07-01

URI Parameters

Name	In	Required	Type	Description
jobName	path	True	string pattern: ^[-\w\._\(\)]+$	Job Name
resourceGroupName	path	True	string minLength: 1 maxLength: 90	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string (uuid)	The ID of the target subscription. The value must be an UUID.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Body

Name	Type	Description
containers	JobExecutionContainer[]	List of container definitions for the Container Apps Job.
initContainers	JobExecutionContainer[]	List of specialized containers that run before job containers.

Responses

Name	Type	Description
200 OK	JobExecutionBase	Azure operation completed successfully.
202 Accepted		Resource operation accepted. Headers Location: string Retry-After: integer
Other Status Codes	DefaultErrorResponse	An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Run a Container Apps Job

Sample request

HTTP

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/testcontainerAppsJob0/start?api-version=2026-07-01

{
  "containers": [
    {
      "name": "testcontainerAppsJob0",
      "image": "repo/testcontainerAppsJob0:v4",
      "resources": {
        "cpu": 0.2,
        "memory": "100Mi"
      }
    }
  ],
  "initContainers": [
    {
      "name": "testinitcontainerAppsJob0",
      "args": [
        "-c",
        "while true; do echo hello; sleep 10;done"
      ],
      "command": [
        "/bin/sh"
      ],
      "image": "repo/testcontainerAppsJob0:v4",
      "resources": {
        "cpu": 0.2,
        "memory": "100Mi"
      }
    }
  ]
}

Sample response

Status code:

200

{
  "name": "testcontainerAppsJob0-pjxhsye",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/jobs/{containerAppsJobName}/executions/{jobExecutionName}"
}

Status code:

202

Location: location

Definitions

Name	Description
ContainerResources	Container App container resource requirements.
DefaultErrorResponse	App Service error response.
DefaultErrorResponseError	Error model.
DefaultErrorResponseErrorDetailsItem	Detailed errors.
EnvironmentVar	Container App container environment variable.
JobExecutionBase	Container App's Job execution name.
JobExecutionContainer	Container Apps Jobs execution container definition.
JobExecutionTemplate	Job's execution template, containing container configuration for a job's execution

ContainerResources

Object

Container App container resource requirements.

Name	Type	Description
cpu	number (double)	Required CPU in cores, e.g. 0.5
ephemeralStorage	string	Ephemeral Storage, e.g. "1Gi"
memory	string	Required memory, e.g. "250Mb"

DefaultErrorResponse

Object

App Service error response.

Name	Type	Description
error	DefaultErrorResponseError	Error model.

DefaultErrorResponseError

Object

Error model.

Name	Type	Description
code	string	Standardized string to programmatically identify the error.
details	DefaultErrorResponseErrorDetailsItem[]	Details or the error
innererror	string	More information to debug error.
message	string	Detailed error description and debugging information.
target	string	Detailed error description and debugging information.

DefaultErrorResponseErrorDetailsItem

Object

Detailed errors.

Name	Type	Description
code	string	Standardized string to programmatically identify the error.
message	string	Detailed error description and debugging information.
target	string	Detailed error description and debugging information.

EnvironmentVar

Object

Container App container environment variable.

Name	Type	Description
name	string	Environment variable name.
secretRef	string	Name of the Container App secret from which to pull the environment variable value.
value	string	Non-secret environment variable value.

JobExecutionBase

Object

Container App's Job execution name.

Name	Type	Description
id	string	Job execution Id.
name	string	Job execution name.

JobExecutionContainer

Object

Container Apps Jobs execution container definition.

Name	Type	Description
args	string[]	Container start command arguments.
command	string[]	Container start command.
env	EnvironmentVar[]	Container environment variables.
image	string	Container image tag.
name	string	Custom container name.
resources	ContainerResources	Container resource requirements.

JobExecutionTemplate

Object

Job's execution template, containing container configuration for a job's execution

Name	Type	Description
containers	JobExecutionContainer[]	List of container definitions for the Container Apps Job.
initContainers	JobExecutionContainer[]	List of specialized containers that run before job containers.