Create

POST

/listing/listings/create/v1

Creates a Listing for a TaskGroup that the caller’s org coordinates. Snapshots participants by unioning ad-hoc picks with expanded bidding groups. When auto_open_priced_bid_threads is True, also auto-opens one BidThread per resolved participant with a lister-side seed Bid carrying default-rate-sheet-derived pricing (falling back to the listing’s pro_forma_line_items when no rate sheet is configured for a participant) — listing insert and thread inserts are atomic. | authz: allowed_org_types=[provider], min_org_role=operator | (ListingClientCreate1) -> (PydanticObjectId)

Creates a Listing for a TaskGroup that the caller's org coordinates. Snapshots participants by unioning ad-hoc picks with expanded bidding groups. When `auto_open_priced_bid_threads` is True, also auto-opens one BidThread per resolved participant with a lister-side seed Bid carrying default-rate-sheet-derived pricing (falling back to the listing's `pro_forma_line_items` when no rate sheet is configured for a participant) — listing insert and thread inserts are atomic. | authz: allowed_org_types=[provider], min_org_role=operator | (ListingClientCreate1) -> (PydanticObjectId)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

listing_descriptionstringRequired

task_group_idstringRequired

task_group_summary_for_biddersstringRequired

audienceenumRequired

Allowed values:

schema_versionintegerOptionalDefaults to 1

pro_forma_line_itemslist of objectsOptional

share_pro_forma_line_itemsbooleanOptionalDefaults to false

participant_provider_org_idslist of stringsOptional

org_bidding_group_idslist of stringsOptional

participant_driver_idslist of stringsOptional

driver_bidding_group_idslist of stringsOptional

typeenumOptional

Allowed values:

auto_award_first_acceptbooleanOptionalDefaults to false

auto_open_priced_bid_threadsbooleanOptionalDefaults to false

internal_notesstringOptional<=524288 characters

Response

Successful Response

Errors

422

Listings Create V1request Unprocessable Entity Error

1	import { ChrtClient } from "@chrt-inc/typescript-sdk";
2
3	async function main() {
4	const client = new ChrtClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.listing.listings.createV1({
8	listing_description: "listing_description",
9	task_group_id: "task_group_id",
10	task_group_summary_for_bidders: "task_group_summary_for_bidders",
11	audience: "providers",
12	});
13	}
14	main();