Rapidata

Rapidata Settings API

The Settings API from Rapidata — 7 operation(s) for settings.

GitHub OpenAPI
Business capability
Subscription Billing & Revenue Management BC-4250

Operations 7

POST /billing/billing-item/{billingItemId}/settings Creates a billing setting for a billing item #
POST /billing/customer/{customerId}/settings Creates a billing setting for a customer #
POST /billing/settings Creates a global billing setting #
DELETE /billing/billing-item/{billingItemId}/settings/{settingId} Deletes a billing item billing setting #
DELETE /billing/customer/{customerId}/settings/{settingId} Deletes a customer billing setting #
DELETE /billing/settings/{settingId} Deletes a global billing setting #
GET /billing/settings/timeline Gets the billing settings timeline #

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/rapidata/refs/heads/main/authentication/rapidata-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/rapidata/refs/heads/main/openapi/rapidata-settings-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/rapidata/refs/heads/main/scopes/rapidata-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/rapidata/refs/heads/main/conventions/rapidata-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/rapidata/refs/heads/main/errors/rapidata-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/rapidata/refs/heads/main/data-model/rapidata-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/rapidata-settings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

rapidata-settings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Rapidata Settings API
  description: The API for the Rapidata Asset service
  version: v1
servers:
- url: https://api.rapidata.ai/
tags:
- name: Settings
  x-displayName: Settings
paths:
  /billing/billing-item/{billingItemId}/settings:
    post:
      tags:
      - Settings
      summary: Creates a billing setting for a billing item
      parameters:
      - name: billingItemId
        in: path
        description: The billing item identifier.
        required: true
        schema:
          type: string
      requestBody:
        description: The billing setting data.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBillingItemBillingSettingEndpoint_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: postBillingBillingItemByBillingItemIdSettings
      x-operation-id-source: derived
  /billing/customer/{customerId}/settings:
    post:
      tags:
      - Settings
      summary: Creates a billing setting for a customer
      parameters:
      - name: customerId
        in: path
        description: The customer identifier.
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        description: The billing setting data.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCustomerBillingSettingEndpoint_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: postBillingCustomerByCustomerIdSettings
      x-operation-id-source: derived
  /billing/settings:
    post:
      tags:
      - Settings
      summary: Creates a global billing setting
      requestBody:
        description: The billing setting data.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateGlobalBillingSettingEndpoint_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: postBillingSettings
      x-operation-id-source: derived
  /billing/billing-item/{billingItemId}/settings/{settingId}:
    delete:
      tags:
      - Settings
      summary: Deletes a billing item billing setting
      parameters:
      - name: billingItemId
        in: path
        description: The billing item identifier.
        required: true
        schema:
          type: string
      - name: settingId
        in: path
        description: The billing setting identifier.
        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: deleteBillingBillingItemByBillingItemIdSettingsBySettingId
      x-operation-id-source: derived
  /billing/customer/{customerId}/settings/{settingId}:
    delete:
      tags:
      - Settings
      summary: Deletes a customer billing setting
      parameters:
      - name: customerId
        in: path
        description: The customer identifier.
        required: true
        schema:
          type: string
          format: uuid
      - name: settingId
        in: path
        description: The billing setting identifier.
        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: deleteBillingCustomerByCustomerIdSettingsBySettingId
      x-operation-id-source: derived
  /billing/settings/{settingId}:
    delete:
      tags:
      - Settings
      summary: Deletes a global billing setting
      parameters:
      - name: settingId
        in: path
        description: The billing setting identifier.
        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: deleteBillingSettingsBySettingId
      x-operation-id-source: derived
  /billing/settings/timeline:
    get:
      tags:
      - Settings
      summary: Gets the billing settings timeline
      parameters:
      - name: customerId
        in: query
        description: Optional customer identifier to scope the timeline.
        schema:
          type: string
          format: uuid
      - name: billingItemId
        in: query
        description: Optional billing item identifier to scope the timeline.
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBillingSettingsTimelineEndpoint_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: getBillingSettingsTimeline
      x-operation-id-source: derived
components:
  schemas:
    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
    CreateCustomerBillingSettingEndpoint_Input:
      type: object
      properties:
        priority:
          type:
          - integer
          - 'null'
          description: The priority of the setting. Defaults to the configured customer default if not specified.
          format: int32
        validFrom:
          type:
          - string
          - 'null'
          description: The start of the validity window.
          format: date-time
        validTo:
          type:
          - string
          - 'null'
          description: The end of the validity window.
          format: date-time
        costPerResponseFreeText:
          type:
          - number
          - 'null'
          description: The cost per free text response.
          format: double
        costPerResponseImage:
          type:
          - number
          - 'null'
          description: The cost per image response.
          format: double
        costPerResponseMediaPerSecond:
          type:
          - number
          - 'null'
          description: The cost per second of media response.
          format: double
        costPerResponseMediaMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per media response.
          format: double
        costPerResponseTextPer50Chars:
          type:
          - number
          - 'null'
          description: The cost per 50 characters of text response.
          format: double
        costPerResponseContextTextPer50Chars:
          type:
          - number
          - 'null'
          description: The cost per 50 characters of context text.
          format: double
        costPerResponseContextTextMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per context text.
          format: double
        costPerResponseContextImage:
          type:
          - number
          - 'null'
          description: The cost per context image.
          format: double
        costPerResponseContextVideoPerSecond:
          type:
          - number
          - 'null'
          description: The cost per second of context video.
          format: double
        costPerResponseContextVideoMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per context video.
          format: double
        discountRatio:
          type:
          - number
          - 'null'
          description: The discount ratio (0-1, e.g. 0.10 = 10% off).
          format: double
      description: The billing setting input data.
    CreateBillingItemBillingSettingEndpoint_Input:
      type: object
      properties:
        priority:
          type:
          - integer
          - 'null'
          description: The priority of the setting. Defaults to the configured billing item default if not specified.
          format: int32
        validFrom:
          type:
          - string
          - 'null'
          description: The start of the validity window.
          format: date-time
        validTo:
          type:
          - string
          - 'null'
          description: The end of the validity window.
          format: date-time
        costPerResponseFreeText:
          type:
          - number
          - 'null'
          description: The cost per free text response.
          format: double
        costPerResponseImage:
          type:
          - number
          - 'null'
          description: The cost per image response.
          format: double
        costPerResponseMediaPerSecond:
          type:
          - number
          - 'null'
          description: The cost per second of media response.
          format: double
        costPerResponseMediaMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per media response.
          format: double
        costPerResponseTextPer50Chars:
          type:
          - number
          - 'null'
          description: The cost per 50 characters of text response.
          format: double
        costPerResponseContextTextPer50Chars:
          type:
          - number
          - 'null'
          description: The cost per 50 characters of context text.
          format: double
        costPerResponseContextTextMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per context text.
          format: double
        costPerResponseContextImage:
          type:
          - number
          - 'null'
          description: The cost per context image.
          format: double
        costPerResponseContextVideoPerSecond:
          type:
          - number
          - 'null'
          description: The cost per second of context video.
          format: double
        costPerResponseContextVideoMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per context video.
          format: double
        discountRatio:
          type:
          - number
          - 'null'
          description: The discount ratio (0-1, e.g. 0.10 = 10% off).
          format: double
      description: The billing setting input data.
    GetBillingSettingsTimelineEndpoint_Output:
      required:
      - intervals
      type: object
      properties:
        intervals:
          allOf:
          - type: array
            items:
              $ref: '#/components/schemas/GetBillingSettingsTimelineEndpoint_Output_Interval'
          description: The billing settings intervals.
    GetBillingSettingsTimelineEndpoint_Output_Interval:
      required:
      - costPerResponseFreeText
      - costPerResponseImage
      - costPerResponseMediaPerSecond
      - costPerResponseMediaMinimum
      - costPerResponseTextPer50Chars
      - costPerResponseContextTextPer50Chars
      - costPerResponseContextTextMinimum
      - costPerResponseContextImage
      - costPerResponseContextVideoPerSecond
      - costPerResponseContextVideoMinimum
      - discountRatio
      type: object
      properties:
        from:
          type:
          - string
          - 'null'
          format: date-time
        to:
          type:
          - string
          - 'null'
          format: date-time
        costPerResponseFreeText:
          type: number
          format: double
        costPerResponseImage:
          type: number
          format: double
        costPerResponseMediaPerSecond:
          type: number
          format: double
        costPerResponseMediaMinimum:
          type: number
          format: double
        costPerResponseTextPer50Chars:
          type: number
          format: double
        costPerResponseContextTextPer50Chars:
          type: number
          format: double
        costPerResponseContextTextMinimum:
          type: number
          format: double
        costPerResponseContextImage:
          type: number
          format: double
        costPerResponseContextVideoPerSecond:
          type: number
          format: double
        costPerResponseContextVideoMinimum:
          type: number
          format: double
        discountRatio:
          type: number
          format: double
    CreateGlobalBillingSettingEndpoint_Input:
      type: object
      properties:
        priority:
          type:
          - integer
          - 'null'
          description: The priority of the setting. Defaults to the configured global default if not specified.
          format: int32
        validFrom:
          type:
          - string
          - 'null'
          description: The start of the validity window.
          format: date-time
        validTo:
          type:
          - string
          - 'null'
          description: The end of the validity window.
          format: date-time
        costPerResponseFreeText:
          type:
          - number
          - 'null'
          description: The cost per free text response.
          format: double
        costPerResponseImage:
          type:
          - number
          - 'null'
          description: The cost per image response.
          format: double
        costPerResponseMediaPerSecond:
          type:
          - number
          - 'null'
          description: The cost per second of media response.
          format: double
        costPerResponseMediaMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per media response.
          format: double
        costPerResponseTextPer50Chars:
          type:
          - number
          - 'null'
          description: The cost per 50 characters of text response.
          format: double
        costPerResponseContextTextPer50Chars:
          type:
          - number
          - 'null'
          description: The cost per 50 characters of context text.
          format: double
        costPerResponseContextTextMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per context text.
          format: double
        costPerResponseContextImage:
          type:
          - number
          - 'null'
          description: The cost per context image.
          format: double
        costPerResponseContextVideoPerSecond:
          type:
          - number
          - 'null'
          description: The cost per second of context video.
          format: double
        costPerResponseContextVideoMinimum:
          type:
          - number
          - 'null'
          description: The minimum cost per context video.
          format: double
        discountRatio:
          type:
          - number
          - 'null'
          description: The discount ratio (0-1, e.g. 0.10 = 10% off).
          format: double
      description: The billing setting input data.
  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