SmartMatchApp

Attach Tag to Task

Attach an existing tag to a specific task. If the tag is already attached, the request is idempotent and returns 204.

Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/tasks/<task_id>/tags/" \
    -u <token>: \
    -X POST \
    -d "tag_id=1"
Request Parameters:

tag_id: Required. The ID of the tag to attach. The tag must belong to the same board as the task.

Example Success Response:
HTTP 204 No Content
Base Request:

Method: POST

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

Rate Limits:

10 requests within 10 seconds

Error Responses:
400 Bad Request

This error occurs if tag_id is missing, the tag does not exist, or the tag belongs to a different board.
Possible errors: "Tag does not exist.", "Tag must belong to the same board as the task."
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 the task with the specified ID does not exist.
Possible errors: "object does not exist"
405 Method Not Allowed

This error occurs if an HTTP method other than POST 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"