> ## Documentation Index > Fetch the complete documentation index at: https://docs.salad.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Job > Creates a new job *Last Updated: July 1, 2025* ## OpenAPI ````yaml api-specs/salad-cloud.yaml post /organizations/{organization_name}/projects/{project_name}/queues/{queue_name}/jobs openapi: 3.1.0 info: title: SaladCloud API description: >- The SaladCloud REST API. Please refer to the [SaladCloud API Documentation](https://docs.salad.com/api-reference) for more details. termsOfService: https://salad.com/terms contact: name: SaladCloud Support url: https://salad.com email: cloud@salad.com license: name: MIT License identifier: MIT version: 0.9.0-alpha.17 servers: - url: https://api.salad.com/api/public security: - ApiKeyAuth: [] tags: - name: container_groups description: Container Groups - name: inference_endpoints description: Inference Endpoints - name: organization_data description: Auxiliary organization data and info - name: queues description: Job Queues - name: quotas description: quotas - name: system_logs description: System Logs - name: webhook_secret_key description: Webhook Secret Key - name: logs description: Platform and Application Log Entries - name: Availability description: Sce Node Availability paths: /organizations/{organization_name}/projects/{project_name}/queues/{queue_name}/jobs: summary: Jobs in a Queue description: Operations for jobs in a queue parameters: - $ref: '#/components/parameters/organization_name' - $ref: '#/components/parameters/project_name' - $ref: '#/components/parameters/queue_name' post: tags: - queues summary: Create Job description: Creates a new job operationId: create_queue_job requestBody: $ref: '#/components/requestBodies/CreateQueueJob' responses: '201': $ref: '#/components/responses/CreateQueueJob' '400': $ref: '#/components/responses/400' '404': $ref: '#/components/responses/404' '429': $ref: '#/components/responses/429' default: $ref: '#/components/responses/UnknownError' x-codeSamples: - source: >- using Salad.Cloud.SDK; using Salad.Cloud.SDK.Config; using Salad.Cloud.SDK.Models; var config = new SaladCloudSdkConfig{}; var client = new SaladCloudSdkClient(config); var input = new QueueJobPrototype(new object {}, new object {}, "webhook"); var response = await client.Queues.CreateQueueJobAsync(input, "acme-corp", "dev-env", "fifo-queue"); Console.WriteLine(response); lang: C# - source: |- import com.salad.cloud.sdk.SaladCloudSdk; import com.salad.cloud.sdk.config.ApiKeyAuthConfig; import com.salad.cloud.sdk.config.SaladCloudSdkConfig; import com.salad.cloud.sdk.models.QueueJob; import com.salad.cloud.sdk.models.QueueJobPrototype; public class Main { public static void main(String[] args) { SaladCloudSdkConfig config = SaladCloudSdkConfig.builder() .apiKeyAuthConfig(ApiKeyAuthConfig.builder().apiKey("YOUR_API_KEY").build()) .build(); SaladCloudSdk saladCloudSdk = new SaladCloudSdk(config); QueueJobPrototype queueJobPrototype = QueueJobPrototype.builder() .input(new Object()) .metadata(new Object()) .webhook("webhook") .build(); QueueJob response = saladCloudSdk.queues.createQueueJob("acme-corp", "dev-env", "fifo-queue", queueJobPrototype); System.out.println(response); } } lang: Java - source: >- import ( "fmt" "encoding/json" "context" "github.com/saladtechnologies/salad-cloud-sdk-go/pkg/saladcloudsdkconfig" "github.com/saladtechnologies/salad-cloud-sdk-go/pkg/saladcloudsdk" "github.com/saladtechnologies/salad-cloud-sdk-go/pkg/util" "github.com/saladtechnologies/salad-cloud-sdk-go/pkg/queues" ) config := saladcloudsdkconfig.NewConfig() config.SetApiKey("API_KEY") client := saladcloudsdk.NewSaladCloudSdk(config) request := queues.QueueJobPrototype{ Input: []byte{}, Metadata: []byte{}, Webhook: util.ToPointer("webhook"), } response, err := client.Queues.CreateQueueJob(context.Background(), "acme-corp", "dev-env", "fifo-queue", request) if err != nil { panic(err) } fmt.Println(response) lang: Go - source: >- import { QueueJobPrototype, SaladCloudSdk } from '@saladtechnologies-oss/salad-cloud-sdk'; (async () => { const saladCloudSdk = new SaladCloudSdk({ apiKey: 'YOUR_API_KEY', }); const queueJobPrototype: QueueJobPrototype = { input: [], metadata: {}, webhook: 'webhook', }; const { data } = await saladCloudSdk.queues.createQueueJob('acme-corp', 'dev-env', 'fifo-queue', queueJobPrototype); console.log(data); })(); lang: TypeScript - source: |- from salad_cloud_sdk import SaladCloudSdk from salad_cloud_sdk.models import QueueJobPrototype sdk = SaladCloudSdk( api_key="YOUR_API_KEY", api_key_header="YOUR_API_KEY_HEADER", timeout=10000 ) request_body = QueueJobPrototype( input="", metadata={}, webhook="webhook" ) result = sdk.queues.create_queue_job( request_body=request_body, organization_name="acme-corp", project_name="dev-env", queue_name="fifo-queue" ) print(result) lang: Python components: parameters: organization_name: name: organization_name in: path description: >- Your organization name. This identifies the billing context for the API operation and represents a security boundary for SaladCloud resources. The organization must be created before using the API, and you must be a member of the organization. required: true schema: $ref: '#/components/schemas/OrganizationName' project_name: name: project_name in: path description: >- Your project name. This represents a collection of related SaladCloud resources. The project must be created before using the API. required: true schema: $ref: '#/components/schemas/ProjectName' queue_name: in: path name: queue_name required: true schema: type: string examples: - fifo-queue maxLength: 63 minLength: 2 pattern: ^[a-z][a-z0-9-]{0,61}[a-z0-9]$ description: The queue name. requestBodies: CreateQueueJob: required: true content: application/json: schema: $ref: '#/components/schemas/QueueJobPrototype' responses: '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' CreateQueueJob: description: Created headers: Location: schema: type: string examples: - >- /organizations/acme-corp/projects/anvil-drop-simulator/queues/queue-1/jobs/job-1 maxLength: 255 minLength: 1 pattern: ^.*$ content: application/json: schema: $ref: '#/components/schemas/QueueJob' links: get_queue_job_by_name: operationId: get_queue_job parameters: queue_job_id: $response.body#/id UnknownError: description: Unknown Error content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' schemas: OrganizationName: description: The organization name. type: string examples: - acme-corp maxLength: 63 minLength: 2 pattern: ^[a-z][a-z0-9-]{0,61}[a-z0-9]$ title: Organization Name ProjectName: description: The project name. type: string examples: - dev-env maxLength: 63 minLength: 2 pattern: ^[a-z][a-z0-9-]{0,61}[a-z0-9]$ QueueJobPrototype: description: Represents a request to create a queue job type: object properties: input: $ref: '#/components/schemas/QueueJobInput' metadata: $ref: '#/components/schemas/QueueJobMetadata' webhook: description: The webhook to call when the job completes type: string format: url maxLength: 2048 minLength: 1 pattern: ^.*$ required: - input QueueJob: description: Represents a queue job type: object properties: create_time: description: The job creation time type: string format: date-time events: description: The job events type: array items: $ref: '#/components/schemas/QueueJobEvent' maxItems: 1000 minItems: 0 id: description: The job identifier type: string format: uuid input: $ref: '#/components/schemas/QueueJobInput' metadata: $ref: '#/components/schemas/QueueJobMetadata' output: $ref: '#/components/schemas/QueueJobOutput' status: description: The job status type: string enum: - pending - running - succeeded - cancelled - failed update_time: description: The job update time type: string format: date-time webhook: description: The webhook URL to notify when the job completes type: string format: url maxLength: 27 minLength: 20 pattern: >- ^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$ required: - id - input - status - events - create_time - update_time ProblemDetails: description: Represents an API error type: object properties: detail: description: >- The human-readable explanation specific to this occurrence of the error. type: string examples: - The container group could not be found. maxLength: 2000 minLength: 1 instance: description: >- The URI reference that identifies the specific occurrence of the error. type: string format: url examples: - https://example.com/error-instances/12345 maxLength: 2048 minLength: 1 status: description: >- The HTTP status code generated by the origin server for this occurrence of the error. type: integer format: int32 examples: - 404 maximum: 599 minimum: 100 title: description: The short, human-readable summary of the error type. type: string examples: - Not Found maxLength: 2000 minLength: 1 type: description: The URI reference that identifies the error type. type: string format: url default: about:blank examples: - https://example.com/errors/invalid-request maxLength: 2048 minLength: 1 QueueJobInput: description: The job input. May be any valid JSON. QueueJobMetadata: description: Additional metadata for the job type: object maxProperties: 20 QueueJobEvent: description: Represents an event for queue job type: object properties: action: description: The action that was taken on the queue job type: string enum: - created - started - succeeded - cancelled - failed time: description: The time the action was taken on the queue job type: string format: date-time required: - action - time QueueJobOutput: description: The job output. May be any valid JSON. securitySchemes: ApiKeyAuth: type: apiKey in: header name: Salad-Api-Key ````