openapi: 3.2.0 info: description: Relevance AI Endpoints title: Relevance AI Endpoints Marketplace API version: latest contact: email: dev@tryrelevance.com servers: - url: /latest security: - AuthorizationHeader: - Authorization tags: - name: Marketplace paths: /marketplace/{listing_display_id}: delete: summary: DeleteMarketplaceListing tags: - Marketplace description: 'Deletes a marketplace listing ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: DeleteMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/DeleteMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/DeleteMarketplaceListingOutput' patch: summary: UpdateMarketplaceListing tags: - Marketplace description: 'Updates a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: UpdateMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/UpdateMarketplaceListingOutput' /marketplace/{listing_display_id}/approve: post: summary: ApproveMarketplaceListing tags: - Marketplace description: 'Approves a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ApproveMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/ApproveMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ApproveMarketplaceListingOutput' /marketplace/{listing_display_id}/reject: post: summary: RejectMarketplaceListing tags: - Marketplace description: 'Rejects a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: RejectMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/RejectMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/RejectMarketplaceListingOutput' /marketplace/{listing_display_id}/clone: post: summary: CloneMarketplaceListing tags: - Marketplace description: 'Clones a marketplace listing ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: CloneMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/CloneMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/CloneMarketplaceListingOutput' /marketplace/submit: post: summary: SubmitMarketplaceListing tags: - Marketplace description: 'Submits a new listing to the marketplace. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: SubmitMarketplaceListing parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/SubmitMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/SubmitMarketplaceListingOutput' /marketplace/{listing_display_id}/version: post: summary: CreateMarketplaceListingVersion tags: - Marketplace description: 'Creates a new version of a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: CreateMarketplaceListingVersion parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateMarketplaceListingVersionInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/CreateMarketplaceListingVersionOutput' /marketplace/my-listings: get: summary: ListOwnMarketplaceListings tags: - Marketplace description: 'Retrieves marketplace listings for a project. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ListOwnMarketplaceListings parameters: - in: query name: page schema: default: 1 type: number description: '' - in: query name: pageSize schema: default: 10 type: number description: '' - in: query name: orderBy schema: default: created_at type: string enum: - name - entity_type - created_at - updated_at - price_usd_cents - clone_count description: '' - in: query name: orderDirection schema: default: desc type: string enum: - asc - desc description: '' - in: query name: entityType schema: type: array items: type: string enum: - agent - tool - workforce description: '' - in: query name: approvalStatus schema: type: array items: type: string enum: - pending - approved - rejected description: '' - in: query name: published schema: type: string enum: - 'true' - 'false' description: '' - in: query name: category schema: type: array items: type: string description: '' - in: query name: tag schema: type: array items: type: string description: '' - in: query name: searchQuery schema: type: string description: '' - in: query name: builderProjectDisplayId schema: type: array items: type: string description: '' - in: query name: priceType schema: type: string enum: - free - paid description: '' - in: query name: minPrice schema: type: number description: '' - in: query name: maxPrice schema: type: number description: '' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListOwnMarketplaceListingsOutput' /marketplace/listings: get: summary: ListPublishedMarketplaceListings tags: - Marketplace description: 'Retrieves all approved and published marketplace listings. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ListPublishedMarketplaceListings parameters: - in: query name: page schema: default: 1 type: number description: '' - in: query name: pageSize schema: default: 10 type: number description: '' - in: query name: orderBy schema: default: created_at type: string enum: - name - entity_type - created_at - updated_at - price_usd_cents - clone_count description: '' - in: query name: orderDirection schema: default: desc type: string enum: - asc - desc description: '' - in: query name: entityType schema: type: array items: type: string enum: - agent - tool - workforce description: '' - in: query name: category schema: type: array items: type: string description: '' - in: query name: tag schema: type: array items: type: string description: '' - in: query name: searchQuery schema: type: string description: '' - in: query name: builderProjectDisplayId schema: type: array items: type: string description: '' - in: query name: priceType schema: type: string enum: - free - paid description: '' - in: query name: minPrice schema: type: number description: '' - in: query name: maxPrice schema: type: number description: '' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListPublishedMarketplaceListingsOutput' /marketplace/listings/{listing_display_id}/published: get: summary: GetPublishedMarketplaceListing tags: - Marketplace description: 'Gets a published marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetPublishedMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetPublishedMarketplaceListingOutput' /marketplace/listings/pending-versions: get: summary: GetPendingVersionsForMarketplaceListings tags: - Marketplace description: 'Gets pending versions for an array of marketplace listings. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetPendingVersionsForMarketplaceListings parameters: - in: query name: listing_display_ids schema: type: array items: type: string description: '' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetPendingVersionsForMarketplaceListingsOutput' /marketplace/listings/{listing_display_id}: get: summary: GetMarketplaceListingByDisplayId tags: - Marketplace description: 'Gets a marketplace listing by display ID. Returns base listing data (respects permissions: own listings + published listings). Use /published or /pending-versions endpoints for specific versions. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetMarketplaceListingByDisplayId parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetMarketplaceListingByDisplayIdOutput' /marketplace/listings/entity/{entity_display_id}: get: summary: GetMarketplaceListingByEntityDisplayId tags: - Marketplace description: 'Gets a marketplace listing by entity display ID. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetMarketplaceListingByEntityDisplayId parameters: - name: entity_display_id in: path description: ID of entity_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetMarketplaceListingByEntityDisplayIdOutput' /marketplace/builders/{project_display_id}/stripe: post: summary: LinkStripeAccountToBuilder tags: - Marketplace description: 'Links a stripe account to a builder. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: LinkStripeAccountToBuilder parameters: - name: project_display_id in: path description: ID of project_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/LinkStripeAccountToBuilderInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/LinkStripeAccountToBuilderOutput' /marketplace/builders: post: summary: UpsertBuilder tags: - Marketplace description: 'Creates or updates a builder. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: UpsertBuilder parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UpsertBuilderInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/UpsertBuilderOutput' get: summary: ListMarketplaceBuilders tags: - Marketplace description: 'Lists builders. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ListMarketplaceBuilders parameters: - in: query name: searchQuery schema: type: string description: '' - in: query name: page schema: type: number description: '' - in: query name: pageSize schema: type: number default: 20 description: '' - in: query name: orderBy schema: type: string enum: - name - created_at - updated_at description: '' - in: query name: orderDirection schema: type: string enum: - asc - desc description: '' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListMarketplaceBuildersOutput' /marketplace/builders/upload-image: post: summary: UploadMarketplaceImage tags: - Marketplace description: 'Upload an image for marketplace builders. Image is validated for authenticity, profile images resized to 500x500 (1MB max), listing and cover images keep original size (3MB max), converted to WebP format, and stored permanently via CloudFront CDN. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: UploadMarketplaceImage parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/UploadMarketplaceImageInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/UploadMarketplaceImageOutput' /marketplace/listings/{listing_display_id}/assets: delete: summary: DeleteMarketplaceListingAsset tags: - Marketplace description: 'Delete an asset from a marketplace listing. Removes the asset from the listing''s assets array and deletes the image from S3 storage (best-effort). ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: DeleteMarketplaceListingAsset parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/DeleteMarketplaceListingAssetInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/DeleteMarketplaceListingAssetOutput' /marketplace/builders/{project_display_id}: get: summary: GetBuilder tags: - Marketplace description: 'Gets a builder. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetBuilder parameters: - name: project_display_id in: path description: ID of project_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetBuilderOutput' /marketplace/{listing_display_id}/publish: post: summary: PublishMarketplaceListing tags: - Marketplace description: 'Updates the published status of a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: PublishMarketplaceListing parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/PublishMarketplaceListingInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublishMarketplaceListingOutput' /marketplace/purchases/checkout: post: summary: CreateCheckoutSession tags: - Marketplace description: 'Creates a checkout session. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: CreateCheckoutSession parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateCheckoutSessionInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/CreateCheckoutSessionOutput' /marketplace/purchases/{project_display_id}: get: summary: ListMarketplacePurchases tags: - Marketplace description: 'Lists all marketplace purchases for a project. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ListMarketplacePurchases parameters: - name: project_display_id in: path description: ID of project_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListMarketplacePurchasesOutput' /marketplace/purchases/{project_display_id}/{listing_display_id}: get: summary: GetPurchase tags: - Marketplace description: 'Gets a marketplace purchase for a project. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetPurchase parameters: - name: project_display_id in: path description: ID of project_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetPurchaseOutput' /marketplace/public/listings: get: summary: ListPublishedMarketplaceListingsPublic tags: - Marketplace description: 'Retrieves all approved and published marketplace listings (public endpoint). ### Required permissions > []' operationId: ListPublishedMarketplaceListingsPublic parameters: - in: query name: page schema: default: 1 type: number description: '' - in: query name: pageSize schema: default: 10 type: number description: '' - in: query name: orderBy schema: default: created_at type: string enum: - name - entity_type - created_at - updated_at - price_usd_cents - clone_count description: '' - in: query name: orderDirection schema: default: desc type: string enum: - asc - desc description: '' - in: query name: entityType schema: type: array items: type: string enum: - agent - tool - workforce description: '' - in: query name: category schema: type: array items: type: string description: '' - in: query name: tag schema: type: array items: type: string description: '' - in: query name: searchQuery schema: type: string description: '' - in: query name: builderProjectDisplayId schema: type: array items: type: string description: '' - in: query name: priceType schema: type: string enum: - free - paid description: '' - in: query name: minPrice schema: type: number description: '' - in: query name: maxPrice schema: type: number description: '' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListPublishedMarketplaceListingsPublicOutput' /marketplace/public/listings/{listing_display_id}: get: summary: GetPublishedMarketplaceListingPublic tags: - Marketplace description: 'Gets a published marketplace listing (public endpoint). ### Required permissions > []' operationId: GetPublishedMarketplaceListingPublic parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetPublishedMarketplaceListingPublicOutput' /marketplace/listings/{listing_display_id}/reviews: post: summary: AddListingReview tags: - Marketplace description: 'Adds a review to a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: AddListingReview parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/AddListingReviewInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/AddListingReviewOutput' get: summary: GetListingReviews tags: - Marketplace description: 'Gets reviews for a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: GetListingReviews parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/GetListingReviewsOutput' /marketplace/reviews/my-reviews: get: summary: ListOwnMarketplaceReviews tags: - Marketplace description: 'Gets all reviews created by the current user. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ListOwnMarketplaceReviews parameters: [] responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListOwnMarketplaceReviewsOutput' /marketplace/listings/{listing_display_id}/reviews/{listing_review_id}: patch: summary: UpdateListingReview tags: - Marketplace description: 'Updates a review on a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: UpdateListingReview parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ - name: listing_review_id in: path description: ID of listing_review required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateListingReviewInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/UpdateListingReviewOutput' delete: summary: DeleteListingReview tags: - Marketplace description: 'Deletes a review from a marketplace listing. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: DeleteListingReview parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ - name: listing_review_id in: path description: ID of listing_review required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/DeleteListingReviewInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/DeleteListingReviewOutput' /marketplace/listings/{listing_display_id}/reviews/{listing_review_id}/publisher-reply: put: summary: AddPublisherReply tags: - Marketplace description: 'Adds a publisher reply to a review. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: AddPublisherReply parameters: - name: listing_display_id in: path description: ID of listing_display required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ - name: listing_review_id in: path description: ID of listing_review required: true schema: type: string maxLength: 240 pattern: ^[a-zd._-]+$ requestBody: content: application/json: schema: $ref: '#/components/schemas/AddPublisherReplyInput' responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/AddPublisherReplyOutput' /marketplace/reviews/on-my-listings: get: summary: ListOwnedListingsReviews tags: - Marketplace description: 'Gets all reviews for listings owned by the current user''s project. Supports pagination and filtering. ### Required permissions > [ { "actions": [ "role:editor" ] } ]' operationId: ListOwnedListingsReviews parameters: - in: query name: limit schema: type: number description: 'Maximum number of reviews to return (default: 50)' description: 'Maximum number of reviews to return (default: 50)' - in: query name: offset schema: type: number description: 'Number of reviews to skip for pagination (default: 0)' description: 'Number of reviews to skip for pagination (default: 0)' - in: query name: search schema: type: string description: Search query for filtering by listing name, review comment, or author name description: Search query for filtering by listing name, review comment, or author name - in: query name: ratings schema: type: string description: Comma-separated list of ratings to filter by (e.g., '1,2,3') description: Comma-separated list of ratings to filter by (e.g., '1,2,3') - in: query name: replied schema: type: boolean description: Filter by whether publisher has replied (true) or not (false) description: Filter by whether publisher has replied (true) or not (false) responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ListOwnedListingsReviewsOutput' components: schemas: LinkStripeAccountToBuilderInput: type: object properties: country_code: type: string business_type: type: string enum: - individual - company - non_profit - government_entity required: - country_code - business_type additionalProperties: false GetPendingVersionsForMarketplaceListingsOutput: type: object properties: {} additionalProperties: type: object properties: id: type: string listing_display_id: type: string approval_status: type: string enum: - pending - approved - rejected author_user_display_id: type: string author_user_email: type: string connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false created_at: type: string updated_at: type: string entity_display_id: type: string entity_s3_path: type: string entity_version_display_id: type: string integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string rejection_reason: type: - string - 'null' required: - id - listing_display_id - approval_status - author_user_display_id - author_user_email - connections - created_at - updated_at - entity_display_id - entity_s3_path - entity_version_display_id - integrations - oauth_accounts - agents - tools - workforces - triggers additionalProperties: false GetMarketplaceListingByEntityDisplayIdOutput: type: object properties: entity_display_id: type: string entity_version_display_id: type: string name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD can_clone: type: boolean description: Whether the listing can be cloned via clone/sharing link can_republish: type: boolean description: Whether the listing can be republished to the marketplace example_task_id: oneOf: - type: string - type: 'null' description: Example task id for the listing assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes approval_status: type: string enum: - pending - approved - rejected author_user_display_id: type: string author_user_email: type: string connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false created_at: type: string updated_at: type: string entity_s3_path: type: string integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string rejection_reason: type: - string - 'null' author_org_display_id: type: string author_project_display_id: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string entity_project_display_id: type: string entity_region: type: string published: type: boolean builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number pending_version_id: oneOf: - type: string - type: 'null' published_version_id: oneOf: - type: string - type: 'null' example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses additionalProperties: false required: - entity_display_id - entity_version_display_id - name - description - image - entity_type - categories - tags - price_usd_cents - approval_status - author_user_display_id - author_user_email - connections - created_at - updated_at - entity_s3_path - integrations - oauth_accounts - agents - tools - workforces - triggers - author_org_display_id - author_project_display_id - published_at - display_id - entity_project_display_id - entity_region - published - builder_name - builder_profile_picture_url - clone_count - pending_version_id - published_version_id UpsertBuilderOutput: type: object properties: project_display_id: type: string stripe_account_id: oneOf: - type: string - type: 'null' onboarding_status: oneOf: - type: string enum: - pending - complete - type: 'null' created_at: type: string updated_at: type: string email: type: string name: type: string org_display_id: type: string region: type: string profile_picture_url: oneOf: - type: string - type: 'null' cover_picture_url: oneOf: - type: string - type: 'null' socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' bio: oneOf: - type: string maxLength: 300 - type: 'null' required: - project_display_id - stripe_account_id - onboarding_status - created_at - updated_at - email - name - org_display_id - region - profile_picture_url - cover_picture_url additionalProperties: false AddPublisherReplyOutput: type: object properties: display_id: type: string listing_display_id: type: string author_display_name: type: string author_user_display_id: type: string author_user_region: type: string listing_id: type: string rating: type: number minimum: 1 maximum: 5 comment: type: string publisher_reply: oneOf: - type: string - type: 'null' created_at: type: string updated_at: type: string required: - display_id - author_display_name - author_user_display_id - author_user_region - rating - publisher_reply - created_at - updated_at additionalProperties: false UpdateMarketplaceListingInput: type: object properties: name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD can_clone: type: boolean description: Whether the listing can be cloned via clone/sharing link can_republish: type: boolean description: Whether the listing can be republished to the marketplace example_task_id: oneOf: - type: string - type: 'null' description: Example task id for the listing youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes additionalProperties: false DeleteMarketplaceListingAssetInput: type: object properties: asset_id: type: string format: uuid description: UUID of the asset to delete additionalProperties: false required: - asset_id AddListingReviewOutput: type: object properties: display_id: type: string listing_display_id: type: string author_display_name: type: string author_user_display_id: type: string author_user_region: type: string listing_id: type: string rating: type: number minimum: 1 maximum: 5 comment: type: string publisher_reply: oneOf: - type: string - type: 'null' created_at: type: string updated_at: type: string required: - display_id - author_display_name - author_user_display_id - author_user_region - rating - publisher_reply - created_at - updated_at additionalProperties: false GetListingReviewsOutput: type: object properties: reviews: type: array items: type: object properties: display_id: type: string listing_display_id: type: string author_display_name: type: string author_user_display_id: type: string author_user_region: type: string listing_id: type: string rating: type: number minimum: 1 maximum: 5 comment: type: string publisher_reply: oneOf: - type: string - type: 'null' created_at: type: string updated_at: type: string required: - display_id - author_display_name - author_user_display_id - author_user_region - rating - publisher_reply - created_at - updated_at additionalProperties: false average_rating: type: number total_count: type: number required: - reviews - average_rating - total_count additionalProperties: false ApproveMarketplaceListingInput: type: object properties: override: type: boolean description: Force approval of rejected listing. Defaults to false. additionalProperties: false DeleteListingReviewInput: {} DeleteMarketplaceListingOutput: type: object properties: display_id: type: string is_deleted: type: boolean LinkStripeAccountToBuilderOutput: type: object properties: onboarding_link: type: string required: - onboarding_link additionalProperties: false SubmitMarketplaceListingInput: type: object properties: entity_display_id: type: string entity_version_display_id: type: string name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD can_clone: type: boolean description: Whether the listing can be cloned via clone/sharing link can_republish: type: boolean description: Whether the listing can be republished to the marketplace example_task_id: oneOf: - type: string - type: 'null' description: Example task id for the listing youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes additionalProperties: false required: - entity_display_id - entity_version_display_id - name - description - image - entity_type - categories - tags - price_usd_cents ListOwnedListingsReviewsOutput: type: object properties: reviews: type: array items: type: object properties: display_id: type: string listing_display_id: type: string author_display_name: type: string author_user_display_id: type: string author_user_region: type: string listing_id: type: string rating: type: number minimum: 1 maximum: 5 comment: type: string publisher_reply: oneOf: - type: string - type: 'null' created_at: type: string updated_at: type: string listing_name: oneOf: - type: string - type: 'null' listing_entity_type: oneOf: - type: string - type: 'null' listing_image: oneOf: - type: string - type: 'null' additionalProperties: false required: - display_id - author_display_name - author_user_display_id - author_user_region - rating - publisher_reply - created_at - updated_at total_count: type: number required: - reviews - total_count additionalProperties: false UploadMarketplaceImageOutput: type: object properties: image_url: type: string description: CloudFront CDN URL of the uploaded and processed image additionalProperties: false required: - image_url UpsertBuilderInput: type: object properties: project_display_id: type: string name: type: string profile_picture_url: type: - string - 'null' cover_picture_url: type: - string - 'null' socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' bio: type: - string - 'null' maxLength: 300 required: - project_display_id - name additionalProperties: false DeleteListingReviewOutput: type: object properties: success: type: boolean message: type: string required: - success - message additionalProperties: false GetMarketplaceListingByDisplayIdOutput: type: object properties: entity_display_id: type: string entity_version_display_id: type: string name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD can_clone: type: boolean description: Whether the listing can be cloned via clone/sharing link can_republish: type: boolean description: Whether the listing can be republished to the marketplace example_task_id: oneOf: - type: string - type: 'null' description: Example task id for the listing assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes approval_status: type: string enum: - pending - approved - rejected author_user_display_id: type: string author_user_email: type: string connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false created_at: type: string updated_at: type: string entity_s3_path: type: string integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string rejection_reason: type: - string - 'null' author_org_display_id: type: string author_project_display_id: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string entity_project_display_id: type: string entity_region: type: string published: type: boolean builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number pending_version_id: oneOf: - type: string - type: 'null' published_version_id: oneOf: - type: string - type: 'null' example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses additionalProperties: false required: - entity_display_id - entity_version_display_id - name - description - image - entity_type - categories - tags - price_usd_cents - approval_status - author_user_display_id - author_user_email - connections - created_at - updated_at - entity_s3_path - integrations - oauth_accounts - agents - tools - workforces - triggers - author_org_display_id - author_project_display_id - published_at - display_id - entity_project_display_id - entity_region - published - builder_name - builder_profile_picture_url - clone_count - pending_version_id - published_version_id CreateCheckoutSessionOutput: type: object properties: checkout_url: type: string required: - checkout_url additionalProperties: false UpdateListingReviewOutput: type: object properties: display_id: type: string listing_display_id: type: string author_display_name: type: string author_user_display_id: type: string author_user_region: type: string listing_id: type: string rating: type: number minimum: 1 maximum: 5 comment: type: string publisher_reply: oneOf: - type: string - type: 'null' created_at: type: string updated_at: type: string required: - display_id - author_display_name - author_user_display_id - author_user_region - rating - publisher_reply - created_at - updated_at additionalProperties: false PublishMarketplaceListingOutput: type: object properties: display_id: type: string published: type: boolean AddPublisherReplyInput: type: object properties: publisher_reply: oneOf: - type: string - type: 'null' required: - publisher_reply additionalProperties: false PublishMarketplaceListingInput: type: object properties: published: type: boolean required: - published additionalProperties: false RejectMarketplaceListingOutput: type: object properties: approval_status: type: string display_id: type: string required: - approval_status - display_id additionalProperties: false ListMarketplacePurchasesOutput: type: array items: type: object properties: listing_display_id: type: string project_display_id: type: string user_display_id: type: string stripe_checkout_session_id: type: string region: type: string purchase_status: type: string enum: - purchased - refund_requested - refunded - pending - failed purchased_at: type: string updated_at: type: string required: - listing_display_id - project_display_id - user_display_id - stripe_checkout_session_id - region - purchase_status - purchased_at - updated_at additionalProperties: false ApproveMarketplaceListingOutput: type: object properties: approval_status: type: string display_id: type: string required: - approval_status - display_id additionalProperties: false UpdateListingReviewInput: type: object properties: rating: type: number minimum: 1 maximum: 5 title: type: string comment: type: string additionalProperties: false GetBuilderOutput: type: object properties: project_display_id: type: string stripe_account_id: oneOf: - type: string - type: 'null' onboarding_status: oneOf: - type: string enum: - pending - complete - type: 'null' created_at: type: string updated_at: type: string email: type: string name: type: string org_display_id: type: string region: type: string profile_picture_url: oneOf: - type: string - type: 'null' cover_picture_url: oneOf: - type: string - type: 'null' socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' bio: oneOf: - type: string maxLength: 300 - type: 'null' stripe_dashboard_url: oneOf: - type: string - type: 'null' required: - project_display_id - stripe_account_id - onboarding_status - created_at - updated_at - email - name - org_display_id - region - profile_picture_url - cover_picture_url - stripe_dashboard_url GetPublishedMarketplaceListingPublicOutput: type: object properties: name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses review_stats: oneOf: - type: object properties: average_rating: type: number total_count: type: number required: - average_rating - total_count additionalProperties: false - type: 'null' additionalProperties: false required: - name - description - image - entity_type - categories - tags - price_usd_cents - connections - integrations - oauth_accounts - agents - tools - workforces - triggers - published_at - display_id - builder_name - builder_profile_picture_url - clone_count GetPurchaseOutput: type: object properties: listing_display_id: type: string project_display_id: type: string user_display_id: type: string stripe_checkout_session_id: type: string region: type: string purchase_status: type: string enum: - purchased - refund_requested - refunded - pending - failed purchased_at: type: string updated_at: type: string required: - listing_display_id - project_display_id - user_display_id - stripe_checkout_session_id - region - purchase_status - purchased_at - updated_at additionalProperties: false DeleteMarketplaceListingAssetOutput: type: object properties: display_id: type: string description: Display ID of the listing deleted_asset_id: type: string description: UUID of the deleted asset additionalProperties: false required: - display_id - deleted_asset_id ListOwnMarketplaceListingsOutput: type: object properties: results: type: array items: type: object properties: entity_display_id: type: string entity_version_display_id: type: string name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD can_clone: type: boolean description: Whether the listing can be cloned via clone/sharing link can_republish: type: boolean description: Whether the listing can be republished to the marketplace example_task_id: oneOf: - type: string - type: 'null' description: Example task id for the listing assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes approval_status: type: string enum: - pending - approved - rejected author_user_display_id: type: string author_user_email: type: string connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false created_at: type: string updated_at: type: string entity_s3_path: type: string integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string rejection_reason: type: - string - 'null' author_org_display_id: type: string author_project_display_id: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string entity_project_display_id: type: string entity_region: type: string published: type: boolean builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number pending_version_id: oneOf: - type: string - type: 'null' published_version_id: oneOf: - type: string - type: 'null' example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses additionalProperties: false required: - entity_display_id - entity_version_display_id - name - description - image - entity_type - categories - tags - price_usd_cents - approval_status - author_user_display_id - author_user_email - connections - created_at - updated_at - entity_s3_path - integrations - oauth_accounts - agents - tools - workforces - triggers - author_org_display_id - author_project_display_id - published_at - display_id - entity_project_display_id - entity_region - published - builder_name - builder_profile_picture_url - clone_count - pending_version_id - published_version_id next_page: type: number required: - results additionalProperties: true GetPublishedMarketplaceListingOutput: type: object properties: name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses review_stats: oneOf: - type: object properties: average_rating: type: number total_count: type: number required: - average_rating - total_count additionalProperties: false - type: 'null' additionalProperties: false required: - name - description - image - entity_type - categories - tags - price_usd_cents - connections - integrations - oauth_accounts - agents - tools - workforces - triggers - published_at - display_id - builder_name - builder_profile_picture_url - clone_count CloneMarketplaceListingInput: type: object properties: overrides: type: object properties: name: type: string description: type: string image: type: string additionalProperties: false version_type: type: string enum: - published - pending additionalProperties: false UploadMarketplaceImageInput: type: object properties: image_base64: type: string description: Base64 encoded image data. Image will be validated, resized based on type, converted to WebP, and uploaded to S3. image_type: type: string enum: - profile - listing - cover description: 'Type of image: profile (resized to 500x500, 1MB max), listing (original size, 3MB max), or cover (original size, 3MB max)' default: cover listing_display_id: type: string description: Optional listing display ID. When provided with image_type='listing', the uploaded image will be automatically added to the listing's assets array. additionalProperties: false required: - image_base64 ListPublishedMarketplaceListingsPublicOutput: type: object properties: results: type: array items: type: object properties: name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses review_stats: oneOf: - type: object properties: average_rating: type: number total_count: type: number required: - average_rating - total_count additionalProperties: false - type: 'null' additionalProperties: false required: - name - description - image - entity_type - categories - tags - price_usd_cents - connections - integrations - oauth_accounts - agents - tools - workforces - triggers - published_at - display_id - builder_name - builder_profile_picture_url - clone_count total: type: number page: type: number pageSize: type: number totalPages: type: number next_page: type: number required: - results - total - page - pageSize - totalPages additionalProperties: true CreateCheckoutSessionInput: type: object properties: listing_display_id: type: string required: - listing_display_id additionalProperties: false ListMarketplaceBuildersOutput: type: object properties: results: type: array items: type: object properties: project_display_id: type: string name: type: string profile_picture_url: oneOf: - type: string - type: 'null' cover_picture_url: oneOf: - type: string - type: 'null' socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' bio: oneOf: - type: string maxLength: 300 - type: 'null' required: - project_display_id - name additionalProperties: false next_page: type: number required: - results additionalProperties: false SubmitMarketplaceListingOutput: type: object properties: display_id: type: string required: - display_id additionalProperties: false CreateMarketplaceListingVersionOutput: type: object properties: listing_display_id: type: string version_id: type: string required: - listing_display_id - version_id additionalProperties: false CreateMarketplaceListingVersionInput: type: object properties: entity_display_id: type: string entity_version_display_id: type: string entity_type: type: string enum: - agent - tool - workforce additionalProperties: false required: - entity_display_id - entity_version_display_id - entity_type ListOwnMarketplaceReviewsOutput: type: array items: type: object properties: display_id: type: string listing_display_id: type: string author_display_name: type: string author_user_display_id: type: string author_user_region: type: string listing_id: type: string rating: type: number minimum: 1 maximum: 5 comment: type: string publisher_reply: oneOf: - type: string - type: 'null' created_at: type: string updated_at: type: string required: - display_id - author_display_name - author_user_display_id - author_user_region - rating - publisher_reply - created_at - updated_at additionalProperties: false CloneMarketplaceListingOutput: type: object properties: entity_type: type: string enum: - agent - tool - workforce entity_display_id: type: string required: - entity_type - entity_display_id additionalProperties: false RejectMarketplaceListingInput: type: object properties: reason: type: string description: Reason for rejection required: - reason additionalProperties: false UpdateMarketplaceListingOutput: type: object properties: entity_display_id: type: string entity_version_display_id: type: string name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD can_clone: type: boolean description: Whether the listing can be cloned via clone/sharing link can_republish: type: boolean description: Whether the listing can be republished to the marketplace example_task_id: oneOf: - type: string - type: 'null' description: Example task id for the listing assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes approval_status: type: string enum: - pending - approved - rejected author_user_display_id: type: string author_user_email: type: string connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false created_at: type: string updated_at: type: string entity_s3_path: type: string integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string rejection_reason: type: - string - 'null' author_org_display_id: type: string author_project_display_id: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string entity_project_display_id: type: string entity_region: type: string published: type: boolean builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number pending_version_id: oneOf: - type: string - type: 'null' published_version_id: oneOf: - type: string - type: 'null' example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses additionalProperties: false required: - entity_display_id - entity_version_display_id - name - description - image - entity_type - categories - tags - price_usd_cents - approval_status - author_user_display_id - author_user_email - connections - created_at - updated_at - entity_s3_path - integrations - oauth_accounts - agents - tools - workforces - triggers - author_org_display_id - author_project_display_id - published_at - display_id - entity_project_display_id - entity_region - published - builder_name - builder_profile_picture_url - clone_count - pending_version_id - published_version_id DeleteMarketplaceListingInput: {} ListPublishedMarketplaceListingsOutput: type: object properties: results: type: array items: type: object properties: name: type: string description: type: string image: type: string description: Image URL for the marketplace entry. entity_type: type: string enum: - agent - tool - workforce categories: type: array items: type: string description: Categories for grouping on the FE e.g. boost_productivity tags: type: array items: type: string description: Tags for use case e.g. Marketing, Sales, etc. price_usd_cents: oneOf: - type: number - type: 'null' description: Price of the listing in cents USD assets: oneOf: - type: array items: type: object properties: id: type: string format: uuid type: type: string enum: - image_url url: type: string format: uri required: - id - type - url additionalProperties: false maxItems: 10 - type: 'null' description: Asset attachments (images) youtube_url: oneOf: - type: string format: uri - type: 'null' description: YouTube video URL for the listing meta_description: oneOf: - type: string - type: 'null' description: Meta description for SEO purposes connections: type: array items: type: object properties: from_display_id: type: string to_display_id: type: string trigger_name: type: string required: - from_display_id - to_display_id additionalProperties: false integrations: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: api_key_provider: type: string logo_key: type: string has_platform_key: type: boolean required: - api_key_provider additionalProperties: false oauth_accounts: type: object additionalProperties: type: object additionalProperties: type: array items: type: object properties: provider: type: string types: type: array items: type: string logo_key: type: string required: - provider - types additionalProperties: false agents: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false tools: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false workforces: type: array items: type: object properties: icon: type: string title: type: string description: type: string display_id: type: string version_display_id: type: string region: type: string project_display_id: type: string required: - icon - title - description - display_id - version_display_id - region - project_display_id additionalProperties: false triggers: type: array items: type: string published_at: oneOf: - type: string - type: 'null' display_id: type: string builder_name: oneOf: - type: string - type: 'null' builder_profile_picture_url: oneOf: - type: string - type: 'null' builder_socials: oneOf: - type: object properties: website: type: - string - 'null' contact_email: type: - string - 'null' linkedin: type: - string - 'null' instagram: type: - string - 'null' additionalProperties: false - type: 'null' clone_count: type: number example_task: oneOf: - type: object properties: title: type: string messages: type: array items: oneOf: - type: object properties: type: type: string text: type: string description: The user's message text display: type: object properties: name: type: string content: type: - string - 'null' is_content_html_safe: type: boolean content_html: type: string message_attachments: type: array items: type: object properties: name: type: string url: type: string contentType: type: string required: - url additionalProperties: false icon: type: string oauth_account_label: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string text: type: string description: The agent's response text agent_details: type: object properties: name: type: string emoji: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - text - item_id additionalProperties: false - type: object properties: type: type: string tool_config: type: object properties: title: type: string description: The tool's title description: type: string description: The tool's description emoji: type: string description: The tool's emoji icon required: - title - description - emoji additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - tool_config - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false task_details: type: object properties: finished_state: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false - type: object properties: type: type: string agent_details: type: object properties: name: type: string emoji: type: string agent_id: type: string additionalProperties: false handover_message: type: string description: Message passed during handover trigger_message_metadata: type: object properties: display_name: type: string display_icon: type: string additionalProperties: false item_id: type: string description: Unique identifier for this task view item parent_item_id: type: string description: ID of the parent item in the task view (if applicable) required: - type - item_id additionalProperties: false required: - title - messages additionalProperties: false - type: object properties: input_params: type: object input_params_metadata: type: object additionalProperties: type: object properties: title: type: string additionalProperties: false output_preview: type: object title: type: string required: - input_params - output_preview - title additionalProperties: false - type: 'null' description: Minified example task showing user messages, tool calls, and agent responses review_stats: oneOf: - type: object properties: average_rating: type: number total_count: type: number required: - average_rating - total_count additionalProperties: false - type: 'null' additionalProperties: false required: - name - description - image - entity_type - categories - tags - price_usd_cents - connections - integrations - oauth_accounts - agents - tools - workforces - triggers - published_at - display_id - builder_name - builder_profile_picture_url - clone_count total: type: number page: type: number pageSize: type: number totalPages: type: number next_page: type: number required: - results - total - page - pageSize - totalPages additionalProperties: true AddListingReviewInput: type: object properties: rating: type: number minimum: 1 maximum: 5 comment: type: string required: - rating additionalProperties: false securitySchemes: AuthorizationHeader: type: apiKey in: header name: Authorization description: 'Authorization credentials. Header authorization should be in the form of: project:api_key'