Skip to content

katana_public_api_client.api.custom_fields.create_custom_field_definition

katana_public_api_client.api.custom_fields.create_custom_field_definition

Classes

Functions

asyncio(*, client, body) async

Create a custom field definition

Creates a new custom field definition.

Parameters:

  • body (CreateCustomFieldDefinitionRequest) –

    Request payload for creating a new custom field definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type': 'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel classification'}.

Raises:

  • UnexpectedStatus

    If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

  • TimeoutException

    If the request takes longer than Client.timeout.

Returns:

Source code in katana_public_api_client/api/custom_fields/create_custom_field_definition.py
async def asyncio(
    *,
    client: AuthenticatedClient | Client,
    body: CreateCustomFieldDefinitionRequest,
) -> CustomFieldDefinition | DetailedErrorResponse | ErrorResponse | None:
    """Create a custom field definition

     Creates a new custom field definition.

    Args:
        body (CreateCustomFieldDefinitionRequest): Request payload for creating a new custom field
            definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type':
            'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel
            classification'}.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.


    Returns:
        CustomFieldDefinition | DetailedErrorResponse | ErrorResponse
    """

    return (
        await asyncio_detailed(
            client=client,
            body=body,
        )
    ).parsed

asyncio_detailed(*, client, body) async

Create a custom field definition

Creates a new custom field definition.

Parameters:

  • body (CreateCustomFieldDefinitionRequest) –

    Request payload for creating a new custom field definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type': 'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel classification'}.

Raises:

  • UnexpectedStatus

    If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

  • TimeoutException

    If the request takes longer than Client.timeout.

Returns:

Source code in katana_public_api_client/api/custom_fields/create_custom_field_definition.py
async def asyncio_detailed(
    *,
    client: AuthenticatedClient | Client,
    body: CreateCustomFieldDefinitionRequest,
) -> Response[CustomFieldDefinition | DetailedErrorResponse | ErrorResponse]:
    """Create a custom field definition

     Creates a new custom field definition.

    Args:
        body (CreateCustomFieldDefinitionRequest): Request payload for creating a new custom field
            definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type':
            'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel
            classification'}.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.


    Returns:
        Response[CustomFieldDefinition | DetailedErrorResponse | ErrorResponse]
    """

    kwargs = _get_kwargs(
        body=body,
    )

    response = await client.get_async_httpx_client().request(**kwargs)

    return _build_response(client=client, response=response)

sync(*, client, body)

Create a custom field definition

Creates a new custom field definition.

Parameters:

  • body (CreateCustomFieldDefinitionRequest) –

    Request payload for creating a new custom field definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type': 'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel classification'}.

Raises:

  • UnexpectedStatus

    If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

  • TimeoutException

    If the request takes longer than Client.timeout.

Returns:

Source code in katana_public_api_client/api/custom_fields/create_custom_field_definition.py
def sync(
    *,
    client: AuthenticatedClient | Client,
    body: CreateCustomFieldDefinitionRequest,
) -> CustomFieldDefinition | DetailedErrorResponse | ErrorResponse | None:
    """Create a custom field definition

     Creates a new custom field definition.

    Args:
        body (CreateCustomFieldDefinitionRequest): Request payload for creating a new custom field
            definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type':
            'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel
            classification'}.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.


    Returns:
        CustomFieldDefinition | DetailedErrorResponse | ErrorResponse
    """

    return sync_detailed(
        client=client,
        body=body,
    ).parsed

sync_detailed(*, client, body)

Create a custom field definition

Creates a new custom field definition.

Parameters:

  • body (CreateCustomFieldDefinitionRequest) –

    Request payload for creating a new custom field definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type': 'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel classification'}.

Raises:

  • UnexpectedStatus

    If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.

  • TimeoutException

    If the request takes longer than Client.timeout.

Returns:

Source code in katana_public_api_client/api/custom_fields/create_custom_field_definition.py
def sync_detailed(
    *,
    client: AuthenticatedClient | Client,
    body: CreateCustomFieldDefinitionRequest,
) -> Response[CustomFieldDefinition | DetailedErrorResponse | ErrorResponse]:
    """Create a custom field definition

     Creates a new custom field definition.

    Args:
        body (CreateCustomFieldDefinitionRequest): Request payload for creating a new custom field
            definition. Example: {'label': 'Channel', 'field_type': 'shortText', 'entity_type':
            'SalesOrder', 'source': 'your-integration', 'description': 'Customer-facing sales channel
            classification'}.

    Raises:
        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
        httpx.TimeoutException: If the request takes longer than Client.timeout.


    Returns:
        Response[CustomFieldDefinition | DetailedErrorResponse | ErrorResponse]
    """

    kwargs = _get_kwargs(
        body=body,
    )

    response = client.get_httpx_client().request(
        **kwargs,
    )

    return _build_response(client=client, response=response)