Gravity AI UI

Use to discover public liked Gravity AI UI interface drafts by title, summary, or id. This returns public gallery metadata only. Use get_interface when you need the full payload or React code for a known id.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Optional text matched against public interface titles and summaries.",
      "type": "string"
    },
    "limit": {
      "description": "Optional maximum result count. Defaults to 10 and is clamped to 1-48.",
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string"
        }
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use when you already have a public Gravity AI UI gallery id and need the sanitized public interface metadata, composed payload, thumbnail URLs, page URL, and copyable React code.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Public Gravity AI UI gallery interface id.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use to generate a new Gravity AI UI composed interface from a prompt. This calls the public generator with the server OpenAI configuration and does not save or publish the result.

{
  "type": "object",
  "properties": {
    "prompt": {
      "description": "Natural-language prompt for the interface to generate.",
      "type": "string",
      "minLength": 1,
      "maxLength": 6000
    },
    "conversationId": {
      "description": "Optional stable conversation id for this generation.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    }
  },
  "required": [
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use to refine a previously generated Gravity AI UI composed payload with a natural-language instruction. This does not save or publish the result.

{
  "type": "object",
  "properties": {
    "instruction": {
      "description": "Natural-language refinement instruction.",
      "type": "string",
      "minLength": 1,
      "maxLength": 6000
    },
    "payload": {
      "description": "Previous composed Gravity interface payload."
    },
    "dataModel": {
      "description": "Optional latest data model for the previous payload."
    },
    "history": {
      "description": "Optional short conversation history for refinement context.",
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "user",
              "assistant"
            ]
          },
          "text": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "surfaceId": {
            "type": "string",
            "minLength": 1,
            "maxLength": 80
          }
        },
        "required": [
          "role",
          "text"
        ]
      }
    },
    "conversationId": {
      "description": "Optional stable conversation id for this refinement.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    }
  },
  "required": [
    "instruction",
    "payload"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}