{
  "id": "workflow:api-versioning-deprecation",
  "_kind": "Workflow",
  "_file": "workflows/workflows/workflows-api-lifecycle.yaml",
  "_cluster": "workflows",
  "attributes": {
    "displayName": "API Versioning and Deprecation",
    "workflowKind": "governance",
    "triggerType": "event-driven",
    "typicalCadence": "per-version",
    "complexity": "cross-team",
    "description": "Manages the lifecycle of API versions from introduction through sunset —\nannouncing deprecation timelines, tracking consumer migration, enforcing\nsunset headers, removing dead endpoints, and archiving documentation.\nExcludes initial API design.\n"
  },
  "outgoingEdges": [
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "role:staff-engineer",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "role:tech-lead",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "role:devrel",
      "kind": "involves_role",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "skill-area:graphql-schema-design",
      "kind": "requires_skill_area",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "skill-area:webhook-verification",
      "kind": "requires_skill_area",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "domain:platform-engineering",
      "kind": "applies_to_domain",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "domain:software-engineering",
      "kind": "applies_to_domain",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "responsibility:review-architecture-changes",
      "kind": "triggers_responsibility",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "responsibility:write-user-docs",
      "kind": "triggers_responsibility",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "org-unit:engineering",
      "kind": "performed_by_org_unit",
      "attributes": {}
    },
    {
      "from": "workflow:api-versioning-deprecation",
      "to": "org-unit:architecture-guild",
      "kind": "performed_by_org_unit",
      "attributes": {}
    }
  ],
  "incomingEdges": [
    {
      "from": "stack-profile:contract-testing",
      "to": "workflow:api-versioning-deprecation",
      "kind": "follows_workflow"
    }
  ]
}