SmartMatchApp

Delete Board Field

Delete a custom field from a board. Deleting a field also removes all of its stored values from every task on the board.

Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/tasks/boards/1/fields/5/" \
    -u <token>: \
    -X DELETE

A successful delete returns 204 No Content.

Base Request:

Method: DELETE

Authentication: Basic Authentication. Requires a valid <token> passed.

Rate Limits:

5 requests within 10 seconds

Error Responses:
401 Unauthorized

This error occurs when the <token> is missing, invalid, or the API access is disabled.

Possible errors: "not authenticated" or "token is disabled" or "Agency API is disabled"
404 Not Found

This error occurs if no field with the given id exists on the board.
Possible errors: "not found"
405 Method Not Allowed

This error occurs if an HTTP method other than DELETE is used.
Possible errors: "wrong method"
429 Too Many Requests

This error occurs when the client has sent too many requests in a given amount of time, leading to rate limiting by the server.

Possible errors: "too many requests"
500 Server Error

Possible errors: "Internal server error"