Delete Schema Field
Removes a user-defined field from a schema.
Only user-defined fields — those created via
[`POST /api/connections/{connection_id}/schemas/{schema_id}/fields`](../../../../../../../api-reference/schemas/upsert-field)
— can be removed through this endpoint. Fields detected automatically from
the source cannot be deleted here; they are managed through schema refresh.
> 🚧 Deleting a field that is referenced in an active sync mapping may cause
> that sync to error on its next execution. Remove or update any dependent
> mappings before deleting the field.
Authentication
AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic
Basic organization-scoped API key
Path parameters
connection_id
Unique identifier of the connection.
schema_id
Identifier of the schema the field belongs to.
field_id
Identifier of the user-defined field to delete.
Headers
X-Polytomic-Version
Response headers
location
Response
Accepted
Errors
400
Bad Request Error
404
Not Found Error
500
Internal Server Error
