POST /tasks/{id}/message

POST https://api.pixydesignapp.com/tasks/{id}/message

Post a line to the task's thread, the same thread the user reads on the project page and in the editor when you finish. Comment as you work. When the batch is done, this is where the commit-style summary of what changed belongs, because acking carries a status and no words.

Header: X-Pixy-Key carrying the agent key (px_sk_…).

Body:

field	type	required	description
text	string	yes	The message.

Response:

field	type	description
messages	array	The whole thread, oldest first, so a reply the user left while you worked arrives with your own post. Each line is {"name", "text", "at"}, and an empty name is the user.

Errors:

error	when
invalid_key	The key is not one of the project's, or was retired.
no_task	The path carries no id, or that id is not this project's.
invalid_message	text is empty.

Example:

curl -X POST https://api.pixydesignapp.com/tasks/9f1c2e40-7b3a-4d51-9a2e-2c8f0b6d1a77/message \
  -H 'X-Pixy-Key: px_sk_yourkey' \
  -H 'Content-Type: application/json' \
  -d '{
        "text": "Moved the price into the card header and dropped the old margin override."
      }'