Graph Operations

Update Graph Metadata

Edit the graph's platform-level label: display name, description, and tags. Partial — only supplied (non-null) fields change; pass "" to clear the description and [] to clear the tags. Requires admin on the graph. This is not the entity name that appears on financial statements — change that through the roboledger update-entity operation.

Idempotency: supply an Idempotency-Key header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.

post/v1/graphs/{graph_id}/operations/update-graph-metadata

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/{graph_id}/operations/update-graph-metadata
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

graph_namestring nullable

New display name. Omit to leave unchanged; cannot be cleared.

descriptionstring nullable

New description. Omit to leave unchanged; pass '' to clear.

tagsstring[] nullable

Replaces the full tag list (not a merge). Omit to leave unchanged; pass [] to clear. Tags are trimmed, de-duplicated, and capped at 50 characters each.

Example request

{
  "graph_name": "Acme Consulting LLC"
}

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

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.