POST
/
schemas
curl --request POST \
  --url https://api.withflora.io/v1/schemas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '""'
{
  "data": {
    "createdAt": "2025-03-20T15:37:16.163+00:00",
    "id": "00f9190e-9a4a-4e08-ba00-f888437ed3c4",
    "name": "News Articles",
    "structure": {
      "items": {
        "properties": {
          "link": {
            "describe": "URL to learn more",
            "type": "string"
          },
          "summary": {
            "describe": "The news summary",
            "type": "string"
          },
          "title": {
            "describe": "The article title",
            "type": "string"
          }
        },
        "type": "object"
      },
      "required": true,
      "type": "array"
    }
  },
  "message": "Schema created successfully",
  "status": true
}

​
Schema Builder Tool

To simplify the process of creating schemas, Flora offers a user-friendly Schema Builder tool. This visual interface allows you to construct your schema graphically, ensuring all requirements are met without the need to write JSON manually. You can access the Schema Builder at https://withflora.io/schema-builder.

Using the Schema Builder:

  1. Navigate to the Schema Builder tool
  2. Use the intuitive interface to add fields and define data types
  3. Preview your schema structure in real-time
  4. Once satisfied, you can directly create the schema via the API or copy the JSON for use in your API requests

The Schema Builder is especially helpful for those new to JSON schema creation or for quickly prototyping complex data structures.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string
Example:

"News Articles"

​
structure
object

Response

200
application/json
200
​
data
object
​
message
string
Example:

"Schema created successfully"

​
status
boolean
Example:

true