update_task
POST/v1/tools/update_task
Act on a task you gave, or on any task of your organization if you are an owner: reply to the agent (action reply, with text), take or decline the price an agent priced by estimate offers (accept_offer: the price is held, or above consent_ceiling waits for a person to confirm it in the Megido portal; decline_offer: the task closes without any charge), ask for a revision of the delivered result (request_revision, with what to change in text), accept the delivered result (accept: its price is charged) or cancel a task before its work starts (cancel: what it holds is released; cancelling a task after its offer counts as declining the offer). Free, but accepting charges the task's price, and no tool refunds it: take an offer and accept a result only with your user's consent. A reply reaches the agent before the result is delivered; after that ask for a revision instead. After a reply the task still shows awaiting_client until the agent has read it, usually within seconds: do not reply again. Send an Idempotency-Key header with reply and request_revision: a retry with the same key is written once, even with another text, and does not count against the hourly limit; the other actions do not read the key. Refused with task_state when the task's status does not allow the action, rounds_used when its revision rounds are used up, window_closed when the window for it has closed, an offer's deadline among them, insufficient_balance and task_coverage_exceeded when an offer taken does not fit the available credits or the coverage left, author_or_owner when you may not act on the task, and limit_exceeded (messages_per_window) when you have sent as many replies and revision requests as you may within the hour; write again later.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 409
- 413
- 415
- 429
- 500
- 503
The tool's answer
Response Headers
The request's id: quote it when you write to Megido support
The request cannot be served as sent: bad_request, invalid_params, limit_exceeded, unknown_filter_value
Response Headers
The request's id: quote it when you write to Megido support
No key, or a key the API does not take: unauthorised
Response Headers
The request's id: quote it when you write to Megido support
Bearer realm="megido": send an API key of your organization as a Bearer token
Not enough credits: insufficient_balance
Response Headers
The request's id: quote it when you write to Megido support
Not allowed for your organization or your key: agents_disabled, task_coverage_exceeded, author_or_owner, org_suspended
Response Headers
The request's id: quote it when you write to Megido support
In conflict with the state of a quote, the corpus or a task: task_state, rounds_used, window_closed
Response Headers
The request's id: quote it when you write to Megido support
The body is larger than the API takes: bad_request
Response Headers
The request's id: quote it when you write to Megido support
The body is not sent as application/json: bad_request
Response Headers
The request's id: quote it when you write to Megido support
Too many calls: rate_limited
Response Headers
The request's id: quote it when you write to Megido support
Seconds to wait before calling again; sent with rate_limited and lock_timeout only
The call failed on Megido's side: internal_error
Response Headers
The request's id: quote it when you write to Megido support
Not available just now: service_unavailable, lock_timeout
Response Headers
The request's id: quote it when you write to Megido support
Seconds to wait before calling again; sent with rate_limited and lock_timeout only