ABMeter Assignment Config API

openapi: 3.2.0
info:
  title: Abmeter Ai Assignment Config API
  version: 1.0.0
  contact:
    name: ABMeter Support
    email: info@abmeter.com
  license:
    name: Commercial
    url: https://abmeter.ai/terms
  description: 'Operations tagged Assignment Config across 2 of this provider''s published API definitions: spec.yaml, abmeter-ai-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://abmeter.ai/api/v1
  description: ABMeter API
security:
- bearerAuth: []
tags:
- name: Assignment Config
paths:
  /assignment-config:
    get:
      summary: Get assignment configuration
      description: Retrieve the complete assignment configuration including all spaces, parameters, experiments, and feature flags. This configuration is used by client SDKs to determine user assignments and parameter values.
      security:
      - bearerAuth: []
      parameters:
      - name: version
        in: query
        required: false
        default: v1
        schema:
          type: string
        description: Configuration schema version to request (currently only v1 supported)
      - name: If-None-Match
        in: header
        required: false
        schema:
          type: string
        description: ETag from previous response - returns 304 if configuration unchanged
      responses:
        '200':
          description: Assignment configuration
          content:
            application/json:
              example:
                version: v1
                config: '{"spaces":[{"id":1,"salt":"deterministic-salt-0"},{"id":2,"salt":"deterministic-salt-1"}],"parameters":[{"id":1,"slug":"parameter-onboarding-message","parameter_type":"String","default_value":"default","space_id":1}],"feature_flags":[{"id":1,"audience":{"id":1,"type":"predicate","predicate":"/test.*@example\\.com$/"},"variant":{"id":1,"parameter_values":[]}}],"experiments":[]}'
              schema:
                $ref: '#/components/schemas/AssignmentConfig'
        '304':
          description: Configuration not modified
        '400':
          description: Unsupported version
          content:
            application/json:
              example:
                error: 'Unsupported version: v2. Only ''v1'' is currently supported.'
                status: 400
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Assignment Config
      operationId: getAssignmentConfig
      x-operation-id-source: derived
    servers:
    - url: https://abmeter.ai/api/v1
      description: ABMeter API
components:
  schemas:
    Error:
      type: object
      description: 'Standard error response format for all API endpoints


        **Important:** The response is ALWAYS an object/hash, never null or any other type.

        The `details` field, when present, is ALWAYS an object/hash (e.g., `{}` not `null` or `[]`).

        The `details` field may be omitted when there are no additional details to provide.'
      properties:
        error:
          type: string
          description: Human-readable error message
        code:
          type: string
          description: Machine-readable error code (optional)
        details:
          type: object
          description: 'Additional error details. When present, ALWAYS an object/hash.

            May contain field-specific errors or other structured information.

            Examples: `{"name": ["can''t be blank"]}` for validation errors, `{"message": "Invalid state"}` for other errors'
          additionalProperties: true
      required:
      - error
    AssignmentConfig:
      type: object
      description: Configuration data for client SDKs to resolve parameters locally
      properties:
        version:
          type: string
          description: Configuration schema version
          readOnly: true
        config:
          type: string
          description: JSON string with assignment configuration
          readOnly: true
      additionalProperties: true
      required:
      - version
      - config
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key from the ABMeter dashboard. Pass it in the Authorization header with 'Bearer' prefix.
x-refined-from:
- spec.yaml
- abmeter-ai-openapi.yml