Future custom segment generation — currently unavailable
const url = 'https://api.infiniteaudience.ai/v1/segments/generate-custom';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"Seed expansion","seed_type":"segment","seed_segment_id":"seg_seed"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.infiniteaudience.ai/v1/segments/generate-custom \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Seed expansion", "seed_type": "segment", "seed_segment_id": "seg_seed" }'Future automated expansion contract for a saved seed segment or organization-salted seed IDs. Requires ‘creator’ scope. Valid requests currently return 501 CUSTOM_GENERATION_NOT_IMPLEMENTED without seed lookup, segment/run creation, queueing, license grant, reservation, usage or charge. Do not retry this as a transient failure. Inputs are bounded and mutually exclusive. A declaration of org_salted is not identity or licensing authorization. Global IDs, arbitrary table references, narrative seeds and model controls are not accepted. A successful asynchronous producer flow and its response contract remain future work; no current 2xx response is promised.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
object
Caller declares organization-salted IDs. Global IDs are not accepted. Actual identity/license validation waits for the future producer integration.
Examples
{ "name": "Seed expansion", "seed_type": "segment", "seed_segment_id": "seg_seed"}{ "name": "ID expansion", "seed_type": "person_ids", "id_namespace": "org_salted", "person_ids": [ "synthetic_salted_person_id" ]}Responses
Section titled “Responses”Invalid request — malformed body, missing required attribute, or failed validation. See error and message for details.
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Examples
{ "error": "Bad Request", "code": "MISSING_SEGMENTS", "message": "segment_ids is required for filter audiences."}Missing or invalid Bearer token. Obtain one via POST /v1/auth/token. When a token was supplied but rejected, code distinguishes TOKEN_EXPIRED (the token’s lifetime has passed — request a new one via POST /v1/auth/token and retry) from TOKEN_INVALID (malformed or revoked — re-authenticate).
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Examples
{ "error": "Unauthorized: Missing or invalid Authorization header"}{ "error": "Unauthorized", "code": "TOKEN_EXPIRED", "message": "Your session has expired. Please sign in again."}Token is valid but lacks the required scope for this endpoint. Check the endpoint description for the required scope (discovery, purchase, or account).
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Examples
{ "error": "SCOPE_REQUIRED", "message": "This endpoint requires the creator scope."}Generation JSON exceeds the 1 MiB request limit. No work is created.
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Example
{ "error": "Payload Too Large", "code": "FST_ERR_CTP_BODY_TOO_LARGE", "message": "Request body is too large"}Automated custom generation is not implemented. No work or charges were created. This is not a transient retry signal.
object
Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.
Human-readable explanation of the error.
Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.
Opaque support/debug identifier when available.
Public action for correcting the request or retrying later.
object
JSON path to the invalid filter field or value.
Example
{ "error": "Not Implemented", "code": "CUSTOM_GENERATION_NOT_IMPLEMENTED", "message": "Automated custom segment generation is not yet available."}