Beta
Configurations
Configurations

Create Configuration

Changed on

Upsert a product configuration; updates if one with the same name + product type + project exists, otherwise creates.

post/api/v1/beta/configurations

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Query parameters

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

namestring required

Human-readable name for this configuration.

Example request

{
  "parameters": {
    "target_pages": "1,3,5-7",
    "max_pages": 10,
    "tier": "cost_effective",
    "version": "latest",
    "extraction_target": "per_doc",
    "system_prompt": "Extract all monetary values in USD. If a currency is not specified, assume USD.",
    "parse_tier": "fast",
    "parse_config_id": "cfg-11111111-2222-3333-4444-555555555555"
  }
}

Response

Successful Response

idstring required

Unique configuration ID.

created_atstring date-time nullable

Creation timestamp.

updated_atstring date-time nullable

Last update timestamp.

namestring required

Configuration name.

product_type'split_v1' | 'extract_v2' | 'classify_v2' | 'parse_v2' | 'spreadsheet_v1' | 'unknown' required

Product type.

versionstring required

Version identifier (datetime string).

Example response

{
  "parameters": {
    "target_pages": "1,3,5-7",
    "max_pages": 10,
    "tier": "cost_effective",
    "version": "latest",
    "extraction_target": "per_doc",
    "system_prompt": "Extract all monetary values in USD. If a currency is not specified, assume USD.",
    "parse_tier": "fast",
    "parse_config_id": "cfg-11111111-2222-3333-4444-555555555555"
  }
}

Changes

  • b17341164de9Revision changes
    • breaking

      removed the enum value 2026-05-28 of the request property ////////

    • breaking

      removed the enum value 2026-05-28 of the request property ///

    • breaking

      removed the enum value 2026-06-01 of the request property ////////

    • breaking

      removed the enum value 2026-06-01 of the request property ///

    • warning

      added the new 2026-06-04 enum value to the //////// response property for the response status

    • warning

      added the new 2026-06-04 enum value to the /// response property for the response status

    • warning

      added the new 2026-06-05 enum value to the //////// response property for the response status

    • warning

      added the new 2026-06-05 enum value to the /// response property for the response status

    • info

      added the new optional request property ///

    • info

      added the new 2026-06-04 enum value to the request property ////////

    • info

      added the new 2026-06-04 enum value to the request property ///

    • info

      added the new 2026-06-05 enum value to the request property ////////

    • info

      added the new 2026-06-05 enum value to the request property ///

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      removed the 2026-05-28 enum value from the //////// response property for the response status

    • info

      removed the 2026-05-28 enum value from the /// response property for the response status

    • info

      removed the 2026-06-01 enum value from the //////// response property for the response status

    • info

      removed the 2026-06-01 enum value from the /// response property for the response status

  • d40e17e17bd1Revision changes
    • breaking

      removed the enum value 2026-05-21 of the request property ////////

    • breaking

      removed the enum value 2026-05-21 of the request property ///

    • warning

      removed the request property //

    • warning

      removed the optional property // from the response with the status

    • warning

      added the new 2026-06-01 enum value to the //////// response property for the response status

    • warning

      added the new 2026-06-01 enum value to the /// response property for the response status

    • info

      added the new optional request property //

    • info

      added the new 2026-06-01 enum value to the request property ////////

    • info

      added the new 2026-06-01 enum value to the request property ///

    • info

      added the optional property // to the response with the status

    • info

      removed the 2026-05-21 enum value from the //////// response property for the response status

    • info

      removed the 2026-05-21 enum value from the /// response property for the response status