Container Schema

Poll async task status

Changed on

Poll the status of the "Set field definitions on a container schema" task.

Asynchronously set field definitions on a container schema. Requires permission to update settings on the schema's registry.

Include every existing field, including archived fields, in the desired order. Provide a field ID to update an existing field; omit the ID to create a new field. Omitted update attributes retain their existing values. To archive a field, set archived to true and provide archiveReason. Omitting a field does not delete it and causes validation to fail. Parent links and numeric ranges are not supported. Configured schema field limits apply, and the request fails if the schema has more items than the configured limit for re-syncing item field values. If the container schema defines the wells of a well plate schema, the number of required fields is limited.

get/api/v3/tasks/container-schema/set-field-definitions/{task_id}

Request

  • Base URL
    https://{tenant_name}.benchling.com
  • Auth
    HTTP bearer

Path parameters

task_idstring required

ID of the asynchronous task to poll.

Headers

EARLY-ACCESSstring

Set to true to access beta operations via /api/v3.

Response

OK

messagestring required
status'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' required

Changes