Moderate a Show & Tell entry

Edit, approve, decline, or unlist an entry. Read its current revision first. Every action advances the revision; use the returned revision for the next action. Approval publishes the reviewed working copy after checking live public access again. Supply versionId from the live version you reviewed. Use approval to restore an unlisted entry. Withdrawn entries require a new creator submission. The live version must still match versionId at approval. Approval records that version as a baseline. Later publishes change the destination content without hiding the listing. Requires current membership of the Show & Tell team.

POST/v1/show-and-tell/moderate

Authorization

AuthorizationBearer token · headerrequired

Better Auth session, OAuth access token, OAuth client-credentials token, or sfm_ Space machine credential.

AuthorizationOAuth2 access token · headerrequired

OAuth 2.0 with explicit Spacefast capability scopes. Use the authorization-code flow for people and client credentials for machines.

Scopes:spaces:write

Request body

requiredapplication/json

One of:

object

titlestring

min length 1 · max length 255

descriptionstring

max length 280

categorystring | null

Show properties

Any of:

string

string

null

null

tagsstring[]

max items 10

creditstring

min length 1 · max length 80

idstringrequired

min length 1 · max length 64

revisionintegerrequired

max 9007199254740991

actionstringrequired

object

idstringrequired

min length 1 · max length 64

revisionintegerrequired

max 9007199254740991

actionstringrequired

versionIdstringrequired

min length 1 · max length 64

object

idstringrequired

min length 1 · max length 64

revisionintegerrequired

max 9007199254740991

actionstringrequired

creatorReasonstringrequired

min length 1 · max length 1000

internalNotestring

max length 2000

object

idstringrequired

min length 1 · max length 64

revisionintegerrequired

max 9007199254740991

actionstringrequired

Responses

200

Response for status 200

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

dataobjectrequired

Show properties

idstringrequired

spaceIdstringrequired

The submitted Space.

statestringrequired

Allowed:pending_reviewapproveddeclinedunlistedwithdrawn

titlestringrequired

creditstringrequired

liveUrlstring<uri>required

revisionnumberrequired

default

Problem details (RFC 9457). Any 4xx/5xx response is one application/problem+json document.

$schemastring<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

typestringrequired

Problem type URI resolving to the error docs page. The server derives it mechanically from code against the docs origin.

titlestringrequired

Short human-readable summary of the problem type. The server derives it mechanically from code.

statusintegerrequired

HTTP status code of this response, repeated in the body.

min -9007199254740991 · max 9007199254740991

detailstringrequired

Human-readable failure explanation for this occurrence.

codestringrequired

Stable snake_case error code naming the failed public contract.

pointerstring

RFC 6901 JSON Pointer into the failing request field, for example "/files/37/path", on validation failures.

detailsobject

Machine-readable context for the error code.

fixstring

One sentence on what to do about this error code, the same text as the type page. Read it before retrying.

suggestionsstring[]

Actionable recovery steps safe to show in dashboards, SDKs, and CLI output.

nextstring[]

Copy-pasteable commands or API requests an agent can run next.

requestIdstringrequired

The request id to quote when contacting support.

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

Request body

Request

curl -X POST 'https://api.spacefast.com/v1/show-and-tell/moderate' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "string",
  "description": "string",
  "category": "apps",
  "tags": [
    "string"
  ],
  "credit": "string",
  "id": "string",
  "revision": 1,
  "action": "edit"
}'

const response = await fetch("https://api.spacefast.com/v1/show-and-tell/moderate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"title\": \"string\",\n  \"description\": \"string\",\n  \"category\": \"apps\",\n  \"tags\": [\n    \"string\"\n  ],\n  \"credit\": \"string\",\n  \"id\": \"string\",\n  \"revision\": 1,\n  \"action\": \"edit\"\n}"
});

import requests

response = requests.post(
    "https://api.spacefast.com/v1/show-and-tell/moderate",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"title\": \"string\",\n  \"description\": \"string\",\n  \"category\": \"apps\",\n  \"tags\": [\n    \"string\"\n  ],\n  \"credit\": \"string\",\n  \"id\": \"string\",\n  \"revision\": 1,\n  \"action\": \"edit\"\n}",
)

Response

{
  "$schema": "http://example.com",
  "data": {
    "id": "string",
    "spaceId": "string",
    "state": "pending_review",
    "title": "string",
    "credit": "string",
    "liveUrl": "http://example.com",
    "revision": 0
  }
}

{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "fix": "string",
  "suggestions": [
    "string"
  ],
  "next": [
    "string"
  ],
  "requestId": "string"
}