Request
Basic information
| Field | Value |
|---|---|
| HTTP URL | https://api.dingtalk.io/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName} |
| HTTP Method | DELETE |
| Supported app type | appType-Internal app |
| Permissions required | permission-Notable.Base.Write.All-AI Table app write permission |
Request header
| Name | Type | Required | Description |
|---|---|---|---|
| x-acs-dingtalk-access-token | String | Yes | The access credential for calling this API. Obtain it by calling the Get the access token of an internal app API. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| baseId | String | Yes | The AI Table ID. For how to obtain it, see Data structure. |
| sheetIdOrName | String | Yes | The Table ID or Table name. Obtain the Table ID in one of the following ways: - Call the Get all tables API. - Call the Get a table API. |
| fieldIdOrName | String | Yes | The field ID or field name. Obtain the field ID by calling the Get all fields API. |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| operatorId | String | Yes | The unionId of the operator. Obtain it in one of the following ways: - Call the Query user details API. - Call the Get user information by silent login code API. |
Request example
HTTPResponse
Response body
| Name | Type | Description |
|---|---|---|
| success | Boolean | Whether the operation succeeded. |
Response body example
Error codes
If an error is returned when you call this API, find the solution in the Global error codes document based on the error message.| HttpCode | Error code | Error message | Description |
|---|---|---|---|
| 500 | internalError | The server encountered an internal error and was unable to complete your request. Please try again later. | System error. |
| 500 | unknownError | Unknown Error | Unknown error. |
| 400 | invalidRequest.inputArgs.invalid | %s | Invalid request parameter. See the error message for details. |
| 400 | invalidRequest.document.stillInitializing | The document is under initialization. Please try again later | The document is being initialized. Try again later. |
| 400 | invalidRequest.document.broken | The document is broken and the server is unable to complete your request. | The document is corrupted. |
| 403 | forbidden.operationIllegal | %s | No permission. |
| 403 | invalidRequest.document.typeIllegal | %s | Unsupported document type. Check the baseId. |
| 404 | invalidRequest.document.notFound | Fail to find the requested resource by the given baseId. Please make sure the given baseId is valid, and the operatorId has permission to access it. | The document does not exist. |
| 404 | invalidRequest.resource.notFound | %s | The resource does not exist. The data does not exist or has been permanently deleted. |
| 504 | service.timeout | The server is busy and unable to complete your request. Please try again later. | Request timed out. |