Skip to content
Spacefast Docs
Esc
↑↓navigate↵open⌘Jpreview

Replace a mutable team tag graph

Replaces a mutable team tag graph when the supplied If-Match graph revision is current.

PUT/v1/teams/{teamId}/tags/versions/{versionId}/graph
Authorization
AuthorizationBearer token · headerrequired
Space key (sfc_…) for an unclaimed anonymous Space. Also the fragment of its claim URL and the token of its /__/<key> door.
or
AuthorizationBearer token · headerrequired
Better Auth session, OAuth access token, agent client-credentials token, or sfm_ Space machine credential.
Path parameters
teamIdstringrequired
versionIdstringrequired
Request body
requiredapplication/json
graphobjectrequired
Tag graph v1 write input. The server enforces these limits: 262144 encoded bytes, 256 tags, 256 triggers, 256 variables, and 64 system modules. The server also enforces 256 items per nested array, 64 keys per object, 65536 encoded bytes per string, and 16 nested levels. Unknown top-level fields are rejected.
Show properties
formatstring
default: "spacefast.tag_graph.v1"
tagsobject[]
max items 256 · default: []
triggersobject[]
max items 256 · default: []
variablesobject[]
max items 256 · default: []
systemModulesobject
default: {}
consentPolicyobject
Responses
200Response 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
versionIdstringrequired
graphobjectrequired
Show properties
formatstringrequired
default: "spacefast.tag_graph.v1"
tagsobject[]required
default: []
triggersobject[]required
default: []
variablesobject[]required
default: []
systemModulesobjectrequired
default: {}
consentPolicyobject
graphRevisionintegerrequired
max 9007199254740991
defaultProblem 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. It resolves 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.
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.
Request
curl -X PUT "https://api.spacefast.com/v1/teams/string/tags/versions/string/graph" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "graph": {
    "format": "spacefast.tag_graph.v1",
    "tags": [],
    "triggers": [],
    "variables": [],
    "systemModules": {},
    "consentPolicy": {
      "property1": null,
      "property2": null
    }
  }
}'
Response
{
  "$schema": "http://example.com",
  "data": {
    "versionId": "string",
    "graph": {
      "format": "spacefast.tag_graph.v1",
      "tags": [],
      "triggers": [],
      "variables": [],
      "systemModules": {},
      "consentPolicy": {
        "property1": null,
        "property2": null
      },
      "property1": null,
      "property2": null
    },
    "graphRevision": 9007199254740991
  }
}