---
title: "POST /audience-generation-job"
method: POST
path: "/audience-generation-job"
---

# POST /audience-generation-job

`POST /audience-generation-job`

Information necessary to start the audience generation job.

## Request body

- object
  - `name` string, required — The name of the audience generation job.
  - `configuredAudienceModelArn` string, required — The Amazon Resource Name (ARN) of the configured audience model that is used for this audience generation job.
  - `seedAudience` object, required — Defines the Amazon S3 bucket where the seed audience for the generating audience is stored.
    - `dataSource` object — <p>Defines the Amazon S3 bucket where the seed audience for the generating audience is stored. A valid data source is a JSON line file in the following format:</p> <p> <code>{"user_id": "111111"}</code> </p> <p> <code>{"user_id": "222222"}</code> </p> <p> <code>...</code> </p>
      - `s3Uri` string, required — The Amazon S3 location URI.
    - `roleArn` string — The ARN of the IAM role that can read the Amazon S3 bucket where the seed audience is stored.
    - `sqlParameters` object — The protected SQL query parameters.
      - `queryString` string — The query string to be submitted.
      - `analysisTemplateArn` string — The Amazon Resource Name (ARN) associated with the analysis template within a collaboration.
      - `parameters` object — The protected query SQL parameters.
    - `sqlComputeConfiguration` ComputeConfiguration — Provides configuration information for the instances that will perform the compute work.
      - `worker` object — The worker instances that will perform the compute work.
        - `type` 'CR.1X' | 'CR.4X' — The instance type of the compute workers that are used.
        - `number` integer — The number of compute workers that are used.
        - `properties` unknown
  - `includeSeedInOutput` boolean — Whether the seed audience is included in the audience generation output.
  - `collaborationId` string — The identifier of the collaboration that contains the audience generation job.
  - `description` string — The description of the audience generation job.
  - `tags` object — <p>The optional metadata that you apply to the resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.</p> <p>The following basic restrictions apply to tags:</p> <ul> <li> <p>Maximum number of tags per resource - 50.</p> </li> <li> <p>For each resource, each tag key must be unique, and each tag key can have only one value.</p> </li> <li> <p>Maximum key length - 128 Unicode characters in UTF-8.</p> </li> <li> <p>Maximum value length - 256 Unicode characters in UTF-8.</p> </li> <li> <p>If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.</p> </li> <li> <p>Tag keys and values are case sensitive.</p> </li> <li> <p>Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for keys as it is reserved for AWS use. You cannot edit or delete tag keys with this prefix. Values can have this prefix. If a tag value has aws as its prefix but the key does not, then Clean Rooms ML considers it to be a user tag and will count against the limit of 50 tags. Tags with only the key prefix of aws do not count against your tags per resource limit.</p> </li> </ul>

## Response `200`

Success

- StartAudienceGenerationJobResponse
  - `audienceGenerationJobArn` string, required — The Amazon Resource Name (ARN) of the audience generation job.

## Other responses

- `480` — ConflictException
- `481` — ValidationException
- `482` — AccessDeniedException
- `483` — ResourceNotFoundException
- `484` — ThrottlingException
- `485` — ServiceQuotaExceededException

---

[API](https://skmtc.net/aws/apis/cleanroomsml.md) · [All operations](https://skmtc.net/aws/apis/cleanroomsml/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/cleanroomsml/versions/d3bb6d6eaa9a/schema)