gallery

Submit

Offer a finished job to the gallery. Nothing is visible until it is approved.

Sharing keeps the job: its result and original are retained past the ordinary schedule, exactly as asking to keep them would, and the gallery shows those retained copies. So a post never outlives what it shows, your own links to a shared result do not expire under it, and withdrawing changes nothing about what you keep. While a job is on the gallery or awaiting review, its retention cannot be turned off — withdraw it first.

post/v1/gallery

Request

  • Base URL: https://api.craterview.ai
  • URL: https://api.craterview.ai/v1/gallery
  • Auth: HTTP bearer

Request body

job_idstring required

The job whose before-and-after you are offering.

consentboolean

Required. Owning a file is not the consent of whoever appears in it, so this must be set deliberately and is never inferred.

keepboolean

No longer needed: sharing keeps the job's files past the ordinary schedule, so this is accepted and has no effect.

descriptionstring nullable

Optional. A sentence or two to show with the picture on the gallery. The reviewer reads it with the submission and may shorten or correct it before publishing.

Response

Successful Response

idstring required

Identifies this submission, for withdrawing it later.

statusstring required

pending until a person decides, then approved or rejected. Nothing appears in the gallery without that decision.

job_idstring required

The job this post shows.

public_modelstring nullable

The model that produced it.

created_atstring nullable

When the post was submitted. ISO-8601, UTC.

decided_notestring nullable

What you were told about the decision, when there is anything to say.

descriptionstring nullable

The description this post goes out with: yours as sent, or as the reviewer edited it on approval.

withdrawnboolean

Whether you have taken this post back. A withdrawn post is not shown and is not reconsidered.

keptboolean

Whether the job's files are retained — kept past the ordinary schedule. True for every new submission: sharing keeps the job.

Changes

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