Rapidata Participant API

openapi: 3.2.0
info:
  title: Rapidata Participant API
  description: The API for the Rapidata Asset service
  version: v1
servers:
- url: https://api.rapidata.ai/
tags:
- name: Participant
  x-displayName: Participant
paths:
  /participant/{participantId}/sample:
    post:
      tags:
      - Participant
      summary: Adds a sample to a participant
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to add the sample to.
        required: true
        schema:
          type: string
      requestBody:
        description: The payload describing the sample to create.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSampleEndpoint_Input'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSampleEndpoint_Output'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: postParticipantByParticipantIdSample
      x-operation-id-source: derived
  /participant/{participantId}/sample-new:
    post:
      tags:
      - Participant
      summary: Adds a sample to a participant
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to add the sample to.
        required: true
        schema:
          type: string
      requestBody:
        description: The payload describing the sample to create.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSampleNewEndpoint_Input'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateSampleNewEndpoint_Output'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: postParticipantByParticipantIdSampleNew
      x-operation-id-source: derived
  /participant/{participantId}:
    delete:
      tags:
      - Participant
      summary: Deletes a participant
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to delete.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: deleteParticipantByParticipantId
      x-operation-id-source: derived
    get:
      tags:
      - Participant
      summary: Gets a participant by its id
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to query.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetParticipantByIdEndpoint_Output'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: getParticipantByParticipantId
      x-operation-id-source: derived
    patch:
      tags:
      - Participant
      summary: Updates a participant using patch semantics
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to update.
        required: true
        schema:
          type: string
      requestBody:
        description: The patch payload describing which fields should change.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateParticipantEndpoint_Input'
        required: true
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: patchParticipantByParticipantId
      x-operation-id-source: derived
  /participant-sample/{sampleId}:
    delete:
      tags:
      - Participant
      summary: Deletes a participant sample
      parameters:
      - name: sampleId
        in: path
        description: The id of the sample to delete.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: deleteParticipantSampleBySampleId
      x-operation-id-source: derived
  /participant/{participantId}/disable:
    post:
      tags:
      - Participant
      summary: Disables a participant in a benchmark
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to disable.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: postParticipantByParticipantIdDisable
      x-operation-id-source: derived
  /participant/{participantId}/enable:
    post:
      tags:
      - Participant
      summary: Enables a previously disabled participant in a benchmark
      description: Fails with 400 if the participant is not currently disabled.
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to enable.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: postParticipantByParticipantIdEnable
      x-operation-id-source: derived
  /participant/{participantId}/faucet:
    delete:
      tags:
      - Participant
      summary: Removes the faucet configuration from a participant
      parameters:
      - name: participantId
        in: path
        description: The id of the participant.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: deleteParticipantByParticipantIdFaucet
      x-operation-id-source: derived
    put:
      tags:
      - Participant
      summary: Sets the faucet used to auto-generate samples for a participant
      parameters:
      - name: participantId
        in: path
        description: The id of the participant whose faucet to set.
        required: true
        schema:
          type: string
      requestBody:
        description: The faucet configuration payload.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IFaucetInput'
        required: true
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: putParticipantByParticipantIdFaucet
      x-operation-id-source: derived
  /participants/{participantId}/submit:
    post:
      tags:
      - Participant
      summary: Submits a participant to a benchmark
      parameters:
      - name: participantId
        in: path
        description: The id of the participant to submit.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitParticipantEndpoint_Output'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: postParticipantsByParticipantIdSubmit
      x-operation-id-source: derived
  /participant/{participantId}/name:
    put:
      tags:
      - Participant
      summary: Updates the name of a participant
      parameters:
      - name: participantId
        in: path
        description: The id of the participant whose name should be updated.
        required: true
        schema:
          type: string
      requestBody:
        description: The payload containing the new participant name.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateParticipantNameEndpoint_Input'
        required: true
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblemDetails'
        '401':
          description: Unauthenticated
        '403':
          description: Forbidden
      security:
      - OpenIdConnect:
        - openid
        - profile
        - email
        - offline_access
      operationId: putParticipantByParticipantIdName
      x-operation-id-source: derived
components:
  schemas:
    IFaucetOutputManagedFaucetOutput:
      required:
      - _t
      properties:
        _t:
          enum:
          - Managed
          type: string
        testTimeScaling:
          type:
          - integer
          - 'null'
          format: int32
    ExistingAssetInput:
      required:
      - name
      type: object
      properties:
        name:
          type: string
        metadata:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/MetadataInputCollection'
        identifier:
          type:
          - string
          - 'null'
    CreateSampleEndpoint_Input:
      required:
      - identifier
      - asset
      type: object
      properties:
        identifier:
          type: string
          description: The identifier used to correlate samples of different participants.
        asset:
          allOf:
          - $ref: '#/components/schemas/IAssetInput'
          description: The asset input for the sample.
    IFaucetOutput:
      required:
      - _t
      type: object
      oneOf:
      - $ref: '#/components/schemas/IFaucetOutputManagedFaucetOutput'
      - $ref: '#/components/schemas/IFaucetOutputReplicateFaucetOutput'
      discriminator:
        propertyName: _t
        mapping:
          Managed: '#/components/schemas/IFaucetOutputManagedFaucetOutput'
          Replicate: '#/components/schemas/IFaucetOutputReplicateFaucetOutput'
    GetParticipantByIdEndpoint_Output:
      required:
      - id
      - name
      - benchmarkId
      - status
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the participant.
        name:
          type: string
          description: The name of the participant.
        benchmarkId:
          type: string
          description: The id of the benchmark the participant belongs to.
        status:
          allOf:
          - $ref: '#/components/schemas/ParticipantStatus'
          description: The status of the participant.
        family:
          type:
          - string
          - 'null'
          description: The family the underlying model belongs to (e.g. "Flux", "GPT"), or null if unset.
        proprietaryName:
          type:
          - string
          - 'null'
          description: The vendor-facing display name of the model, or null if unset.
        logo:
          type:
          - string
          - 'null'
          description: The logo of the model, or null if unset.
        faucet:
          allOf:
          - $ref: '#/components/schemas/IFaucetOutput'
          description: The faucet configured to auto-generate samples, or null if none is set.
    SubmitParticipantEndpoint_Output:
      required:
      - validDatapoints
      - invalidDatapoints
      type: object
      properties:
        validDatapoints:
          type: integer
          description: The number of valid datapoints collected by the participant.
          format: int32
        invalidDatapoints:
          type: integer
          description: The number of invalid datapoints collected by the participant.
          format: int32
    IMetadataInput:
      required:
      - _t
      type: object
      oneOf:
      - $ref: '#/components/schemas/IMetadataInputTextMetadataInput'
      discriminator:
        propertyName: _t
        mapping:
          TextMetadataInput: '#/components/schemas/IMetadataInputTextMetadataInput'
    ValidationProblemDetails:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
        title:
          type:
          - string
          - 'null'
        status:
          type:
          - integer
          - 'null'
          format: int32
        detail:
          type:
          - string
          - 'null'
        instance:
          type:
          - string
          - 'null'
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    IAssetInputTextAssetInput:
      required:
      - text
      - _t
      properties:
        _t:
          enum:
          - TextAssetInput
          type: string
        text:
          type: string
        metadata:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/MetadataInputCollection'
        identifier:
          type:
          - string
          - 'null'
    UpdateParticipantNameEndpoint_Input:
      required:
      - name
      type: object
      properties:
        name:
          type: string
          description: The new name of the participant.
    CreateSampleNewEndpoint_Output:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: The id of the created sample.
    CreateSampleNewEndpoint_Input:
      required:
      - identifier
      - asset
      type: object
      properties:
        identifier:
          type: string
          description: The identifier used to correlate samples of different participants.
        asset:
          allOf:
          - $ref: '#/components/schemas/IAssetInput'
          description: The asset input for the sample.
    IFaucetInput:
      required:
      - _t
      type: object
      oneOf:
      - $ref: '#/components/schemas/IFaucetInputReplicateFaucetInput'
      description: "Polymorphic request body describing a faucet to configure on a participant. The concrete\n type is selected by the _t discriminator (e.g. \"Replicate\")."
      discriminator:
        propertyName: _t
        mapping:
          Replicate: '#/components/schemas/IFaucetInputReplicateFaucetInput'
    IAssetInputMultiAssetInput:
      required:
      - assets
      - _t
      properties:
        _t:
          enum:
          - MultiAssetInput
          type: string
        assets:
          type: array
          items:
            $ref: '#/components/schemas/IAssetInput'
        metadata:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/MetadataInputCollection'
        identifier:
          type:
          - string
          - 'null'
    MetadataVisibilities:
      type: array
      items:
        enum:
        - None
        - Users
        - Customers
        - Admins
        - Dashboard
        - All
        type: string
    IAssetInputExistingAssetInput:
      required:
      - name
      - _t
      properties:
        _t:
          enum:
          - ExistingAssetInput
          type: string
        name:
          type: string
        metadata:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/MetadataInputCollection'
        identifier:
          type:
          - string
          - 'null'
    IFaucetInputReplicateFaucetInput:
      required:
      - modelOwner
      - modelName
      - _t
      properties:
        _t:
          enum:
          - Replicate
          type: string
        modelOwner:
          type: string
          description: The owner of the hosted model (e.g. "stability-ai").
        modelName:
          type: string
          description: The model name (e.g. "sdxl").
        modelVersion:
          type:
          - string
          - 'null'
          description: Optional pinned model version hash.
        additionalInputs:
          type: object
          description: "Extra model inputs keyed by parameter name (e.g. \"aspect_ratio\"). The system-managed keys\n (prompt, num_outputs) must not appear here — they are supplied automatically. Values are\n validated against the model's live input schema when the faucet is set."
      description: Configures a faucet that generates samples via the Replicate API.
    IAssetInput:
      required:
      - _t
      type: object
      oneOf:
      - $ref: '#/components/schemas/IAssetInputExistingAssetInput'
      - $ref: '#/components/schemas/IAssetInputMultiAssetInput'
      - $ref: '#/components/schemas/IAssetInputTextAssetInput'
      discriminator:
        propertyName: _t
        mapping:
          ExistingAssetInput: '#/components/schemas/IAssetInputExistingAssetInput'
          MultiAssetInput: '#/components/schemas/IAssetInputMultiAssetInput'
          TextAssetInput: '#/components/schemas/IAssetInputTextAssetInput'
    UpdateParticipantEndpoint_Input:
      type: object
      properties:
        name:
          type: string
          description: The new name of the participant.
        family:
          type:
          - string
          - 'null'
          description: The family the underlying model belongs to (e.g. "Flux", "GPT"). Pass null to clear.
        proprietaryName:
          type:
          - string
          - 'null'
          description: The vendor-facing display name of the model. Pass null to clear.
        logo:
          type:
          - object
          - 'null'
          oneOf:
          - $ref: '#/components/schemas/ExistingAssetInput'
          description: An image asset for the model's logo. Pass null to clear.
        faucet:
          allOf:
          - $ref: '#/components/schemas/IFaucetInput'
          description: The faucet to set or replace on the participant.
    IMetadataInputTextMetadataInput:
      required:
      - text
      - visibilities
      - _t
      properties:
        _t:
          enum:
          - TextMetadataInput
          type: string
        text:
          type:
          - string
          - 'null'
        visibilities:
          $ref: '#/components/schemas/MetadataVisibilities'
    ParticipantStatus:
      enum:
      - Created
      - Submittable
      - Submitted
      - Disabled
    IFaucetOutputReplicateFaucetOutput:
      required:
      - modelOwner
      - modelName
      - additionalInputs
      - _t
      properties:
        _t:
          enum:
          - Replicate
          type: string
        modelOwner:
          type: string
        modelName:
          type: string
        modelVersion:
          type:
          - string
          - 'null'
        additionalInputs:
          type: object
    MetadataInputCollection:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/IMetadataInput'
    CreateSampleEndpoint_Output:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: The id of the created sample.
  securitySchemes:
    OpenIdConnect:
      type: openIdConnect
      description: OpenID Connect connection flow
      openIdConnectUrl: https://auth.rapidata.ai/.well-known/openid-configuration
x-tagGroups:
- name: Rapidata Asset API
  tags:
  - Asset
  - BatchUpload
- name: Rapidata Audience API
  tags:
  - Audience
  - Examples
- name: Rapidata Campaign API
  tags:
  - Cache
  - Campaign
  - ExternalAudience
- name: Rapidata Dataset API
  tags:
  - ContextShortening
  - Datapoints
  - Dataset
  - DatasetGroup
- name: Rapidata Flow API
  tags:
  - Flow
  - FlowItem
  - RankingFlow
  - RankingFlowItem
- name: Rapidata Identity API
  tags:
  - Rapidata.Identity.API
  - Client
  - Customer
  - Identity
  - Newsletter
  - Organization
  - Survey
- name: Rapidata Leaderboard API
  tags:
  - Benchmark
  - SampleGeneration
  - Faucet
  - Replicate
  - Leaderboard
  - Participant
  - Prompt
  - Sample
- name: Rapidata Order API
  tags:
  - Feedback
  - Job
  - Order
- name: Rapidata Payment API
  tags:
  - Billing
  - ExternalServicePrices
  - Reconciliation
  - Settings
  - VolumeDiscount
  - BillingAccount
  - Invoice
  - Payment
- name: Rapidata Pipeline API
  tags:
  - Pipeline
- name: Rapidata Rapid API
  tags:
  - CustomerRapid
  - GlobalText
  - Rapid
  - UserRapid
  - ValidationFeedback
- name: Rapidata Signal API
  tags:
  - Signal
- name: Rapidata Translation API
  tags:
  - Translation
- name: Rapidata Validation API
  tags:
  - ValidationSet
- name: Rapidata Workflow API
  tags:
  - Evaluation
  - GroupedRanking
  - Ranking
  - SimpleWorkflow
  - Workflow