Graphs

Create New Graph Database

Creates a graph asynchronously. Returns an OperationEnvelope with operation_id for SSE progress at /v1/operations/{operation_id}/stream. Entity graphs require initial_entity. Supports Idempotency-Key header.

post/v1/graphs

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/v1/graphs
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

Idempotency-Keystring nullable

Request body

instance_tierstring

Instance tier: ladybug-standard, ladybug-large, ladybug-xlarge

create_entityboolean

Whether to create the entity node and upload initial data. Only applies when initial_entity is provided. Set to False to create graph without populating entity data (useful for file-based ingestion workflows).

tagsstring[]

Optional tags for organization

Example request

{
  "create_entity": true,
  "initial_entity": {
    "cik": "0001234567",
    "ein": "12-3456789",
    "name": "Acme Consulting LLC",
    "state_of_incorporation": "Delaware",
    "uri": "https://acmeconsulting.com"
  },
  "instance_tier": "ladybug-standard",
  "metadata": {
    "description": "Professional consulting services with full accounting integration",
    "graph_name": "Acme Consulting LLC",
    "schema_extensions": [
      "roboledger"
    ]
  },
  "tags": [
    "consulting",
    "professional-services",
    "production"
  ]
}

Response

Successful Response

operationstring required

Kebab-case operation name

operationIdstring required

op_-prefixed ULID for audit and SSE correlation

status'completed' | 'pending' | 'failed' required

Operation lifecycle state

resultunknown
atstring required

ISO-8601 UTC timestamp

createdBystring nullable

User ID that initiated the operation

idempotentReplayboolean

True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.

Changes

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