Agent

Report something ImageStep could not do

USE THIS WHEN: an op you needed does not exist, a parameter did not behave the way the contract describes, or you were about to work around ImageStep with something local. Reporting the gap is the alternative to routing around it.

Free: no credit, no job, no rate-limit budget beyond the shared API one, and at most 200 reports per account per UTC day — past that, 429 rate_limited until midnight UTC. kind is capability_gap (ImageStep cannot do it at all), bug (it did not behave the way the contract says) or other; message says what you were trying to do. op names the operation when there is one and is not checked against the catalogue — the most useful report is about an op that does not exist yet. context is any JSON object worth keeping.

The report comes back (201) with the apiKeyId it was filed under, so an account running one key per agent can tell whose report it is. It is your account's data: exported with it, and deleted with it or 365 days after it was filed, whichever comes first.

post/api/v1/feedback

Request

  • Base URL: https://api.imagestep.dev
  • URL: https://api.imagestep.dev/api/v1/feedback
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Optional. A client-generated unique key (typically a UUID). Same key + the same request (method, path, query string and body) replays the first response verbatim with Idempotency-Replayed: true, without executing again. Same key + a different one returns 409 idempotency_key_reuse. A repeat that arrives while the first is still running returns 409 request_in_progress, which is retryable. Keys are retained 24 hours. At most 255 characters; a longer one is a 400 invalid_param with param: "Idempotency-Key".

Request body

kind'capability_gap' | 'bug' | 'other' required

What kind of report it is, matched case-insensitively

opstring

The op this is about, when it is about one — any name up to 64 characters; not checked against the catalogue.

messagestring required

What you were trying to do and what stopped you; at most 4000 characters.

contextobject

Anything structured worth keeping — the parameters tried, the client, the model; at most 4000 characters once encoded as JSON.

Example request

{
  "op": "remove_bg"
}

Response

Logged

Changes

No recorded changes to this operation across all 1 revision of this API.