Skip to content

    Pre-launch API. The concepts described here are settled, but the API shape is not: request and response fields, parameters and defaults can still change. Build against it, and talk to your Luigi's Box contact before you put an integration into production.

    Update a feed source

    View source
    PATCH
    /catalog/v1/{catalog_id}/sources/feeds/{feed_id}
    curl --request PATCH \
    --url https://api.eu1.luigisbox.ai/catalog/v1/example/sources/feeds/1 \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{ "active": true, "catalog_type": "example", "csv_delimiter": "example", "csv_has_header": true, "delete_threshold": 1, "expected_version": 1, "format": "xml", "group_id_field": "example", "group_primary_attribute_name": "example", "group_primary_field": "example", "identity_field": "example", "item_tag": "example", "json_path": "example", "mapping_id": 1, "position": 1, "transport_options": {}, "url": "example" }'
    catalog_id
    required
    Catalog Id
    string
    feed_id
    required
    Feed Id
    integer
    Media type application/json
    FeedConfigUpdate
    object
    active
    Any of:
    boolean
    catalog_type
    Any of:
    string
    >= 1 characters
    csv_delimiter
    Any of:
    string
    >= 1 characters <= 1 characters
    csv_has_header
    Any of:
    boolean
    delete_threshold
    Any of:
    number
    <= 1
    expected_version
    required
    Expected Version
    integer
    format
    Any of:
    string
    Allowed values: xml csv json json_lines
    group_id_field
    Any of:
    string
    >= 1 characters
    group_primary_attribute_name
    Any of:
    string
    >= 1 characters
    group_primary_field
    Any of:
    string
    >= 1 characters
    identity_field
    Any of:
    string
    item_tag
    Any of:
    string
    json_path
    Any of:
    string
    mapping_id
    Any of:
    integer
    position
    Any of:
    integer
    transport_options
    Any of:
    object
    key
    additional properties
    any
    url
    Any of:
    string
    >= 1 characters

    Successful Response

    Media type application/json
    Feed
    object
    active
    required
    Active
    boolean
    catalog_id
    required
    Catalog Id
    string
    catalog_type
    required
    Catalog Type
    string
    created_at
    required
    Created At
    string format: date-time
    csv_delimiter
    required
    Any of:
    string
    csv_has_header
    required
    Any of:
    boolean
    delete_threshold
    required
    Any of:
    number
    feed_id
    required
    Feed Id
    integer
    format
    required
    Any of:
    string
    group_id_field
    required
    Any of:
    string
    group_primary_attribute_name
    required
    Any of:
    string
    group_primary_field
    required
    Any of:
    string
    identity_field
    required
    Any of:
    string
    item_tag
    required
    Any of:
    string
    json_path
    required
    Any of:
    string
    mapping_id
    required
    Any of:
    integer
    position
    required
    Position
    integer
    transport_options
    required
    Any of:
    object
    key
    additional properties
    any
    updated_at
    required
    Updated At
    string format: date-time
    url
    required
    Url
    string
    version
    required
    Version
    integer
    Example generated
    {
    "active": true,
    "catalog_id": "example",
    "catalog_type": "example",
    "created_at": "2026-04-15T12:00:00Z",
    "csv_delimiter": "example",
    "csv_has_header": true,
    "delete_threshold": 1,
    "feed_id": 1,
    "format": "example",
    "group_id_field": "example",
    "group_primary_attribute_name": "example",
    "group_primary_field": "example",
    "identity_field": "example",
    "item_tag": "example",
    "json_path": "example",
    "mapping_id": 1,
    "position": 1,
    "transport_options": {},
    "updated_at": "2026-04-15T12:00:00Z",
    "url": "example",
    "version": 1
    }

    Missing or invalid credentials

    Media type application/json
    ErrorResponse

    Canonical error body — every non-2xx response uses this shape.

    object
    exception_details
    ExceptionDetails

    Machine-readable error context; empty object when there is nothing to add.

    object
    validation_errors
    Any of:
    Array<object>
    ValidationProblem

    One field-level reason a request was rejected.

    object
    loc
    required
    Loc

    Path to the offending value from the request root, e.g. ["body", "filters", 0, "operator"].

    Array
    msg
    required
    Msg

    What is wrong with the value at loc.

    string
    type
    required
    Type

    Stable machine code for the problem, e.g. missing or string_too_short.

    string
    key
    additional properties
    any
    reason
    required
    Reason

    Human-readable, actionable error message.

    string
    request_id
    Any of:
    string
    Example generated
    {
    "exception_details": {
    "validation_errors": [
    {
    "loc": [
    "example"
    ],
    "msg": "example",
    "type": "example"
    }
    ]
    },
    "reason": "example",
    "request_id": "example"
    }

    Authenticated but not permitted

    Media type application/json
    ErrorResponse

    Canonical error body — every non-2xx response uses this shape.

    object
    exception_details
    ExceptionDetails

    Machine-readable error context; empty object when there is nothing to add.

    object
    validation_errors
    Any of:
    Array<object>
    ValidationProblem

    One field-level reason a request was rejected.

    object
    loc
    required
    Loc

    Path to the offending value from the request root, e.g. ["body", "filters", 0, "operator"].

    Array
    msg
    required
    Msg

    What is wrong with the value at loc.

    string
    type
    required
    Type

    Stable machine code for the problem, e.g. missing or string_too_short.

    string
    key
    additional properties
    any
    reason
    required
    Reason

    Human-readable, actionable error message.

    string
    request_id
    Any of:
    string
    Example generated
    {
    "exception_details": {
    "validation_errors": [
    {
    "loc": [
    "example"
    ],
    "msg": "example",
    "type": "example"
    }
    ]
    },
    "reason": "example",
    "request_id": "example"
    }

    Resource not found

    Media type application/json
    ErrorResponse

    Canonical error body — every non-2xx response uses this shape.

    object
    exception_details
    ExceptionDetails

    Machine-readable error context; empty object when there is nothing to add.

    object
    validation_errors
    Any of:
    Array<object>
    ValidationProblem

    One field-level reason a request was rejected.

    object
    loc
    required
    Loc

    Path to the offending value from the request root, e.g. ["body", "filters", 0, "operator"].

    Array
    msg
    required
    Msg

    What is wrong with the value at loc.

    string
    type
    required
    Type

    Stable machine code for the problem, e.g. missing or string_too_short.

    string
    key
    additional properties
    any
    reason
    required
    Reason

    Human-readable, actionable error message.

    string
    request_id
    Any of:
    string
    Example generated
    {
    "exception_details": {
    "validation_errors": [
    {
    "loc": [
    "example"
    ],
    "msg": "example",
    "type": "example"
    }
    ]
    },
    "reason": "example",
    "request_id": "example"
    }

    State conflict

    Media type application/json
    ErrorResponse

    Canonical error body — every non-2xx response uses this shape.

    object
    exception_details
    ExceptionDetails

    Machine-readable error context; empty object when there is nothing to add.

    object
    validation_errors
    Any of:
    Array<object>
    ValidationProblem

    One field-level reason a request was rejected.

    object
    loc
    required
    Loc

    Path to the offending value from the request root, e.g. ["body", "filters", 0, "operator"].

    Array
    msg
    required
    Msg

    What is wrong with the value at loc.

    string
    type
    required
    Type

    Stable machine code for the problem, e.g. missing or string_too_short.

    string
    key
    additional properties
    any
    reason
    required
    Reason

    Human-readable, actionable error message.

    string
    request_id
    Any of:
    string
    Example generated
    {
    "exception_details": {
    "validation_errors": [
    {
    "loc": [
    "example"
    ],
    "msg": "example",
    "type": "example"
    }
    ]
    },
    "reason": "example",
    "request_id": "example"
    }

    Request validation failed

    Media type application/json
    ErrorResponse

    Canonical error body — every non-2xx response uses this shape.

    object
    exception_details
    ExceptionDetails

    Machine-readable error context; empty object when there is nothing to add.

    object
    validation_errors
    Any of:
    Array<object>
    ValidationProblem

    One field-level reason a request was rejected.

    object
    loc
    required
    Loc

    Path to the offending value from the request root, e.g. ["body", "filters", 0, "operator"].

    Array
    msg
    required
    Msg

    What is wrong with the value at loc.

    string
    type
    required
    Type

    Stable machine code for the problem, e.g. missing or string_too_short.

    string
    key
    additional properties
    any
    reason
    required
    Reason

    Human-readable, actionable error message.

    string
    request_id
    Any of:
    string
    Example generated
    {
    "exception_details": {
    "validation_errors": [
    {
    "loc": [
    "example"
    ],
    "msg": "example",
    "type": "example"
    }
    ]
    },
    "reason": "example",
    "request_id": "example"
    }