{"openapi":"3.0.1","components":{"links":{"AppLink":{"operationId":"getApp","parameters":{"id":"$response.body#/data/id"}},"AssetLink":{"operationId":"getAsset","parameters":{"id":"$response.body#/data/id"}},"CapabilityLink":{"operationId":"getCapability","parameters":{"id":"$response.body#/data/id"}},"FeatureLink":{"operationId":"getFeature","parameters":{"id":"$response.body#/data/id"}},"GoalLink":{"operationId":"getGoal","parameters":{"id":"$response.body#/data/id"}},"InfluenceLink":{"operationId":"getInfluence","parameters":{"id":"$response.body#/data/id"}},"InformationLink":{"operationId":"getInformation","parameters":{"id":"$response.body#/data/id"}},"InitiativeLink":{"operationId":"getInitiative","parameters":{"id":"$response.body#/data/id"}},"ProcessLink":{"operationId":"getProcess","parameters":{"id":"$response.body#/data/id"}},"ProductLink":{"operationId":"getProduct","parameters":{"id":"$response.body#/data/id"}},"ServiceLink":{"operationId":"getService","parameters":{"id":"$response.body#/data/id"}},"StrategyLink":{"operationId":"getStrategy","parameters":{"id":"$response.body#/data/id"}},"TechnologyLink":{"operationId":"getApp","parameters":{"id":"$response.body#/data/id"}}},"schemas":{"FactCalculated":{"type":"object","properties":{"type":{"type":"string","enum":["calculated"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"value":{"type":"number"}}}},"example":{"type":"calculated","name":"Total Revenue","expires_at":"2026-12-31","data":{"value":1250000.5}}},"FactChoice":{"type":"object","properties":{"type":{"type":"string","enum":["choice"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"value":{"type":"string"},"color":{"type":"string"}}}},"example":{"type":"choice","name":"Status","expires_at":"2026-12-31","data":{"value":"Active","color":"#00FF00"}}},"FactCurrency":{"type":"object","properties":{"type":{"type":"string","enum":["currency"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"value":{"type":"number"}}}},"example":{"type":"currency","name":"Budget","expires_at":"2026-12-31","data":{"value":50000}}},"FactDate":{"type":"object","properties":{"type":{"type":"string","enum":["date"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"value":{"type":"string","format":"date"}}}},"example":{"type":"date","name":"Launch Date","expires_at":"2026-12-31","data":{"value":"2024-12-31"}}},"FactDateRange":{"type":"object","properties":{"type":{"type":"string","enum":["date_range"]},"name":{"type":"string"},"data":{"type":"object","properties":{"start":{"type":"string","format":"date","nullable":true},"end":{"type":"string","format":"date","nullable":true}}}},"example":{"type":"date_range","name":"Project Window","data":{"start":"2024-01-01","end":"2024-12-31"}}},"FactExternal":{"type":"object","properties":{"type":{"type":"string","enum":["external"]},"name":{"type":"string"},"data":{"type":"object","properties":{"value":{"type":"string","nullable":true}}}},"example":{"type":"external","name":"Last Deploy","data":{"value":"2024-06-01"}}},"FactLinkWithStatus":{"type":"object","properties":{"type":{"type":"string","enum":["link_with_status"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"href":{"type":"string"},"status":{"type":"string","enum":["no_status","draft","in_review","approved"]}}}},"example":{"type":"link_with_status","name":"Documentation","expires_at":"2026-12-31","data":{"href":"https://example.com/docs","status":"approved"}}},"FactMultistep":{"type":"object","properties":{"type":{"type":"string","enum":["multistep"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"value":{"type":"string"},"color":{"type":"string"}}}},"example":{"type":"multistep","name":"Progress","expires_at":"2026-12-31","data":{"value":"Phase 2","color":"#FFA500"}}},"FactNumber":{"type":"object","properties":{"type":{"type":"string","enum":["number"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"value":{"type":"number"}}}},"example":{"type":"number","name":"User Count","expires_at":"2026-12-31","data":{"value":1250}}},"FactQuadrant":{"type":"object","properties":{"type":{"type":"string","enum":["quadrant"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"label":{"type":"string"},"definition":{"type":"string"},"color":{"type":"string"}}}},"example":{"type":"quadrant","name":"Priority","expires_at":"2026-12-31","data":{"label":"High Value, Low Effort","definition":"Quick wins that deliver significant value","color":"#00FF00"}}},"FactStakeholder":{"type":"object","properties":{"type":{"type":"string","enum":["stakeholder"]},"name":{"type":"string"},"expires_at":{"type":"string","format":"date","nullable":true,"description":"The last date this fact is trusted, or null if it never expires."},"data":{"type":"object","properties":{"stakeholder_name":{"type":"string"},"stakeholder_id":{"type":"string","format":"uuid"}}}},"example":{"type":"stakeholder","name":"Owner","expires_at":"2026-12-31","data":{"stakeholder_name":"John Smith","stakeholder_id":"550e8400-e29b-41d4-a716-446655440000"}}},"FactRichText":{"type":"object","properties":{"type":{"type":"string","enum":["rich_text"]},"name":{"type":"string"},"data":{"type":"object","properties":{"value":{"type":"string","nullable":true}}}},"example":{"type":"rich_text","name":"Notes","data":{"value":"Migrated from the legacy platform in Q1."}}},"FactUnrestricted":{"type":"object","properties":{"type":{"type":"string","enum":["unrestricted"]},"name":{"type":"string"},"data":{"type":"object","properties":{"value":{"type":"string","nullable":true}}}},"example":{"type":"unrestricted","name":"Owner Team","data":{"value":"Platform Engineering"}}},"Error":{"type":"object","description":"Error responses follow a consistent structure to help you handle errors gracefully in your application.\n\nAll error responses include an `errors` array containing one or more error messages. Each message is a human-readable string describing what went wrong and how to resolve it.\n\n## Common Error Codes\n\n- **400 Bad Request**: The request was malformed or contains invalid data. Check the error messages for specific validation failures.\n- **401 Unauthorized**: Authentication failed. Verify your API key is correct and included in the Authorization header.\n- **403 Forbidden**: Your organisation's plan does not include API Access, or its API Access trial has ended. Contact your account manager.\n- **404 Not Found**: The requested resource does not exist or you don't have access to it. Verify the resource ID is correct.\n- **422 Unprocessable Entity**: The request was well-formed but contains semantic errors. Review the validation errors and correct the data.\n- **500 Internal Server Error**: An unexpected error occurred on our end. Please retry the request or contact support if the issue persists.\n","properties":{"errors":{"type":"array","description":"An array of error messages describing what went wrong. Each message provides specific guidance on how to resolve the issue.","items":{"type":"string","description":"A human-readable error message explaining the issue and how to resolve it"}}},"required":["errors"]},"Fact":{"type":"object","description":"A single fact captured against a Fact Card (topic). Facts are a unified view over the\nunderlying detail answer, assessment, link, and partnership records.\n\nCompound facts (`calculated`, `quadrant`) are computed, read-only projections: they have\nno `id`/`contributor_id`. They appear in the index but cannot be fetched, created, or\nrenewed individually.\n","properties":{"id":{"type":"string","description":"The fact identifier (a UUID or numeric id depending on response_type). Absent for compound facts."},"topic_id":{"type":"string","format":"uuid","description":"The UUID of the Fact Card this fact belongs to"},"response_type":{"type":"string","enum":["calculated","choice","currency","date","date_range","external","link_with_status","multistep","number","quadrant","rich_text","stakeholder","unrestricted"],"description":"The kind of fact, which determines the value shape and the template it belongs to"},"template_id":{"type":"string","format":"uuid","description":"The uuid of the template that defines this fact"},"template_name":{"type":"string"},"contributor_id":{"type":"integer","description":"The id of the user credited as the contributor"},"justification":{"type":"string","nullable":true},"state":{"type":"string","enum":["future","in_effect","expired","superseded","ignored"],"description":"Fact state: ignored or superseded; otherwise period-relative (future/in_effect/expired)"},"superseding_record_id":{"nullable":true,"description":"Id of the fact that superseded this one, or null if current"},"begins_at":{"type":"string","format":"date","nullable":true,"description":"Start of the trust period"},"ends_at":{"type":"string","format":"date","nullable":true,"description":"End of the trust period"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"ignored_at":{"type":"string","format":"date-time","nullable":true,"description":"When the fact was ignored, or null"},"value":{"type":"object","description":"The type-specific value: `response` for detail answers, `href`/`status` for links, `scale_value_id`/`score` for assessments, `partner_id`/`role` for partnerships.","additionalProperties":true}},"required":["response_type","topic_id","template_id","value"]},"FactData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Fact"}},"required":["data"]},"FactArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Fact"}},"metadata":{"type":"object","properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total_count":{"type":"integer"},"total_pages":{"type":"integer"}},"required":["page","per_page","total_count","total_pages"]}},"required":["data","metadata"]},"FactTemplate":{"type":"object","description":"A fact template available for a topic type, with its priority and enough hint to construct a create-fact request.","required":["template_id","name","response_type","priority","description","review_days","lifecycle","applicable_topic_types","value_hint"],"properties":{"template_id":{"type":"string","format":"uuid","description":"The template uuid. Pass this as `template_id` when creating a fact, or to update the template."},"name":{"type":"string","description":"The template name, e.g. \"Owner\" or \"Annual cost\"."},"response_type":{"type":"string","description":"The kind of fact this template captures, e.g. currency, choice, stakeholder."},"priority":{"type":"string","enum":["optional","recommended","required"],"description":"Whether a Fact Card of this topic type must (required), should (recommended), or may (optional) carry this fact."},"description":{"type":"string","description":"What the template captures."},"review_days":{"type":"integer","description":"The review period: how many days a fact created from this template stays trusted before review is required. Used to default `ends_at` on create."},"lifecycle":{"type":"string","enum":["trusted","forecast","expires","planned"],"description":"How the fact behaves over its review period: `trusted` (trusted until the period ends), `expires` (lapses when it ends), `forecast` (a forward-looking projection), or `planned` (the response itself carries the window, as for date ranges)."},"applicable_topic_types":{"type":"array","items":{"type":"string"},"description":"The topic types this template applies to, as the plural API names (e.g. \"capabilities\")."},"justification":{"type":"string","enum":["none","available","required"],"description":"Whether a justification is optional, available, or required alongside the fact. Present only for templates whose facts carry a justification (detail answers and assessments)."},"value_hint":{"type":"object","description":"Guidance for building the create-fact `value` object.","required":["shape"],"properties":{"shape":{"type":"string","enum":["scalar","rich_text","link","stakeholder","choice","score"],"description":"The overall shape of the `value` payload."},"value":{"type":"object","additionalProperties":{"type":"string"},"description":"The keys expected inside `value`, each mapped to a human-readable format hint."},"scale_values":{"type":"array","description":"For choice templates, the allowed answers. Map the user's choice to `value.scale_value_id`.","items":{"type":"object","required":["id","label"],"properties":{"id":{"type":"integer"},"label":{"type":"string"}}}}}}},"example":{"template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c0d","name":"Owner","response_type":"stakeholder","priority":"required","description":"The accountable owner of this capability.","review_days":365,"lifecycle":"trusted","applicable_topic_types":["capabilities"],"value_hint":{"shape":"stakeholder","value":{"stakeholder":"Fact Card UUID of a stakeholder (or supply \"partner_user_id\" instead)","role":"role label (optional)"}}}},"FactTemplateArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FactTemplate"}},"metadata":{"type":"object","properties":{"topic_type":{"type":"string","nullable":true,"description":"The topic type filter that was applied, or null when the whole catalogue was returned."}},"required":["topic_type"]}},"required":["data","metadata"]},"TemplateRequest":{"type":"object","description":"Request body for creating a template. `response_type` picks what is created: a fact template for the detail types, an assessment type for `choice`.","required":["response_type","name","definition"],"properties":{"response_type":{"type":"string","enum":["unrestricted","number","date","currency","date_range","rich_text","choice"],"description":"The kind of fact the template captures. Coming soon: multistep, calculated, link_with_status, quadrant, stakeholder."},"name":{"type":"string","description":"The template name, unique within the workspace."},"definition":{"type":"string","description":"What the template captures."},"template_group_id":{"type":"string","format":"uuid","description":"The Fact Group to file the template in. Defaults to the workspace's default group for the response type."},"justification":{"type":"string","enum":["none","available","required"],"description":"Whether a justification is optional, available, or required alongside each fact. Defaults to `none`."},"applicable_topic_types":{"type":"array","items":{"type":"string"},"description":"The topic types the template applies to, as plural API names (e.g. \"capabilities\"). A type not enabled in the workspace is accepted with a warning."},"priority":{"type":"string","enum":["optional","recommended","required"],"description":"Whether a Fact Card must, should, or may carry this fact. Defaults to `optional`."},"review_days":{"type":"integer","description":"How many days a fact stays trusted before review. Defaults to 365."},"lifecycle":{"type":"string","enum":["trusted","forecast","expires","planned"],"description":"How the fact behaves over its review period. Defaults to `trusted`."},"options":{"$ref":"#/components/schemas/TemplateOptions"}},"example":{"response_type":"currency","name":"Annual cost","definition":"What this costs per year.","applicable_topic_types":["capabilities"],"priority":"required","review_days":365}},"TemplateOptions":{"type":"array","description":"For `choice` templates, the answers to choose from, in display order. On update, an option with an `id` edits that option and one without is added; options cannot be removed through the API.","items":{"type":"object","description":"A new option needs `name`, `definition` and `color`; an edit needs only its `id` and the fields that change.","properties":{"id":{"type":"integer","description":"On update, the option to edit (see `value_hint.scale_values`)."},"name":{"type":"string"},"definition":{"type":"string"},"color":{"type":"string","description":"Hex colour, e.g. \"#ff0000\"."}}}},"TemplateUpdateRequest":{"type":"object","description":"Request body for updating a template. Every field is optional; only those present change. The fields are as for `TemplateRequest`, except that `response_type` cannot be changed.","properties":{"name":{"type":"string"},"definition":{"type":"string"},"template_group_id":{"type":"string","format":"uuid"},"justification":{"type":"string","enum":["none","available","required"]},"applicable_topic_types":{"type":"array","items":{"type":"string"},"description":"Replaces the applicable topic types."},"priority":{"type":"string","enum":["optional","recommended","required"]},"review_days":{"type":"integer"},"lifecycle":{"type":"string","enum":["trusted","forecast","expires","planned"]},"options":{"$ref":"#/components/schemas/TemplateOptions"}},"example":{"name":"Annual cost","priority":"required"}},"TemplateData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FactTemplate"},"warnings":{"type":"array","items":{"type":"string"},"description":"Present when the request succeeded but something needs attention, e.g. a topic type that is not enabled in the workspace."}},"required":["data"]},"TemplateGroup":{"type":"object","description":"A Fact Group: the heading templates are filed under on a Fact Card.","properties":{"id":{"type":"string","format":"uuid","description":"The UUID of the Fact Group. Pass it as `template_group_id` on a template."},"name":{"type":"string","description":"The name of the Fact Group"},"key":{"type":"string","description":"A stable handle for the Fact Group, unique within the workspace. New templates default to `details`, or `assessments` for `choice`."},"description":{"type":"string","nullable":true,"description":"What the Fact Group is for"}},"required":["id","name","key","description"]},"TemplateGroupArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TemplateGroup"}}},"required":["data"]},"FactRequest":{"type":"object","description":"Request body for creating a fact. Mirrors the fact representation: `topic_id`,\n`template_id` (the template's uuid), and `user_id` are always required (the user must have an\nactive membership in the workspace's organisation), and the type-specific value goes in\nthe nested `value` object. `justification`, `begins_at`, and `ends_at` are accepted per\nthe template's configuration.\n\nThe `value` shape depends on `response_type`:\n- detail answers (number, currency, date, date_range, external, rich_text, unrestricted): `{ \"response\": \"...\" }`\n- links (link_with_status): `{ \"href\": \"...\", \"status\": \"approved\" }`\n- assessments: `{ \"scale_value_id\": 1 }` (choice) or `{ \"score\": 3.2 }` (multistep)\n- partnerships (stakeholder): `{ \"stakeholder\": \"<uuid>\", \"role\": \"...\" }` or `{ \"partner_user_id\": 1, \"role\": \"...\" }`\n","required":["topic_id","template_id","user_id"],"properties":{"topic_id":{"type":"string","format":"uuid","description":"The UUID of the Fact Card to attach the fact to"},"response_type":{"type":"string","description":"Optional with a template uuid, which already implies it; when given it must match. Required with a legacy integer `template_id`."},"template_id":{"type":"string","format":"uuid","description":"The uuid of the template (scoped to your workspace). Deprecated: a legacy integer template id is still accepted together with `response_type`."},"user_id":{"type":"integer","description":"The id of the user credited as the contributor (must be an active member of the organisation)"},"justification":{"type":"string","nullable":true},"begins_at":{"type":"string","format":"date","nullable":true,"description":"Start of the trust period (defaults to today)"},"ends_at":{"type":"string","format":"date","nullable":true,"description":"End of the trust period (defaults to today + the template trust period)"},"value":{"type":"object","description":"The type-specific value; keys depend on response_type (see above).","additionalProperties":true}}},"FactCardArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FactCardResponse"}},"connections":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"FactCardData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FactCardResponse"},"connections":{"type":"array","items":{"$ref":"#/components/schemas/Connection"}}}},"FactCardRequest":{"type":"object","description":"Request body for creating or updating a Fact Card. Fact Cards are the core entities in Colloquial, representing business concepts like applications, services, capabilities, and more.\n\nWhen creating a Fact Card, only the `name` field is required. All other fields are optional and can be added or updated later.\n\nWhen updating a Fact Card, only include the fields you want to change. Partial updates are supported - you don't need to send all fields.\n","required":["name"],"properties":{"name":{"type":"string","description":"The primary name of the Fact Card. This is a required field and must be unique within your workspace.","minLength":1,"maxLength":255,"example":"Customer Portal Application"},"aliases":{"description":"Alternative names or aliases for the Fact Card, separated by commas. Useful for handling different naming conventions or abbreviations.","type":"string","nullable":true,"example":"Portal, Customer Portal, CP"},"description":{"type":"string","description":"A detailed description of the Fact Card. Provides context and additional information about what this entity represents.","nullable":true,"minLength":10,"maxLength":5000,"example":"The main customer-facing web application for account management and self-service features"},"tag_ids":{"type":"array","description":"An array of tag IDs to associate with this Fact Card. Tags help categorise and organise your Fact Cards for easier discovery and filtering.","items":{"type":"integer","description":"The ID of a tag to associate with this Fact Card","minimum":1},"example":[1,2,3]},"group_ids":{"type":"array","description":"An array of group UUIDs to assign this Fact Card to. Groups categorise Fact Cards by type (e.g., CapabilityGroup, TechnologyGroup) and must match this Fact Card's type. Providing this field replaces the current set of groups; omit it to leave groups unchanged, or send an empty array to clear them.\n\nMost Fact Card types belong to at most one group, so the array should contain a single UUID; technologies, assets and apps may belong to several. A UUID that is unknown or references a group of the wrong type is rejected with a 422.\n","items":{"type":"string","format":"uuid","description":"The UUID of a group to assign this Fact Card to. Retrieve available groups from GET /api/v1/groups."},"example":["550e8400-e29b-41d4-a716-446655440000"]},"archived":{"description":"Controls the archived status of the Fact Card. Set to `true` to archive it, `false` to restore it, or omit the field to leave the status unchanged.","type":"boolean","default":false,"example":false}}},"FactCardResponse":{"type":"object","description":"A Fact Card represents a core business entity in Colloquial. Each Fact Card has a unique identifier, metadata, and can contain associated facts and connections to other Fact Cards.\n\nFact Cards are the building blocks of your workspace, representing concepts like applications, services, capabilities, technologies, and more. They can be enriched with facts (numbers, dates, choices, etc.) and connected to other Fact Cards to build relationships.\n","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier (UUID) for this Fact Card. Use this ID to reference the Fact Card in API requests.","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string","description":"The primary name of the Fact Card. This is the canonical identifier used throughout the system.","example":"Customer Portal Application"},"aliases":{"description":"Alternative names or aliases for the Fact Card, separated by commas. Useful for handling different naming conventions or abbreviations used across your organisation.","type":"string","nullable":true,"example":"Portal, Customer Portal, CP"},"description":{"type":"string","description":"A detailed description of the Fact Card, providing context and additional information about what this entity represents.","nullable":true,"example":"The main customer-facing web application for account management and self-service features"},"tag_ids":{"type":"array","description":"An array of tag IDs associated with this Fact Card. Tags help categorise and organise Fact Cards for easier discovery and filtering.","items":{"type":"integer","description":"The ID of a tag associated with this Fact Card","minimum":1},"example":[1,2,3]},"group_ids":{"type":"array","description":"An array of group UUIDs associated with this Fact Card. Groups allow you to categorise Fact Cards by type (e.g., CapabilityGroup, TechnologyGroup).","items":{"type":"string","format":"uuid","description":"The UUID of a group associated with this Fact Card"},"example":["550e8400-e29b-41d4-a716-446655440000","660e8400-e29b-41d4-a716-446655440001"]},"archived":{"type":"boolean","description":"Indicates whether this Fact Card is archived. Archived Fact Cards are hidden from default views but can still be accessed via API.","default":false,"example":false},"archived_at":{"description":"The ISO 8601 timestamp when the Fact Card was archived. This field is null if the Fact Card has never been archived.","type":"string","format":"date-time","nullable":true,"example":"2024-01-15T10:30:00Z"},"created_at":{"description":"The ISO 8601 timestamp when the Fact Card was created.","type":"string","format":"date-time","example":"2024-01-15T10:30:00Z"},"updated_at":{"description":"The ISO 8601 timestamp when the Fact Card was last modified. This field is updated whenever any property of the Fact Card changes.","type":"string","format":"date-time","example":"2024-01-20T14:45:00Z"},"fact_set":{"description":"An array of facts associated with this Fact Card. Facts can be of various types (numbers, dates, choices, etc.) and provide structured data about the Fact Card.","type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/FactCalculated"},{"$ref":"#/components/schemas/FactChoice"},{"$ref":"#/components/schemas/FactCurrency"},{"$ref":"#/components/schemas/FactDate"},{"$ref":"#/components/schemas/FactDateRange"},{"$ref":"#/components/schemas/FactExternal"},{"$ref":"#/components/schemas/FactLinkWithStatus"},{"$ref":"#/components/schemas/FactNumber"},{"$ref":"#/components/schemas/FactMultistep"},{"$ref":"#/components/schemas/FactQuadrant"},{"$ref":"#/components/schemas/FactRichText"},{"$ref":"#/components/schemas/FactStakeholder"},{"$ref":"#/components/schemas/FactUnrestricted"}],"discriminator":{"propertyName":"type"}}}},"example":{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Customer Portal Application","aliases":"Portal, Customer Portal, CP","description":"The main customer-facing web application for account management","tag_ids":[1,2,3],"archived":false,"archived_at":null,"created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z","fact_set":[{"type":"number","name":"User Count","data":{"value":1250}},{"type":"choice","name":"Status","data":{"value":"Active","color":"#00FF00"}}]}},"StakeholderArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/FactCardResponse"}}}},"StakeholderData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/FactCardResponse"}}},"StakeholderRequest":{"type":"object","allOf":[{"$ref":"#/components/schemas/FactCardRequest"}],"properties":{"user_id":{"type":"string","nullable":true}}},"StakeholderResponse":{"type":"object","allOf":[{"$ref":"#/components/schemas/FactCardResponse"}],"properties":{"user_id":{"type":"string","nullable":true}},"example":{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Product Manager","description":"Responsible for product strategy and roadmap","tag_ids":[1],"archived":false,"archived_at":null,"created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z","user_id":"660e8400-e29b-41d4-a716-446655440001","fact_set":[]}},"Status":{"description":"The status of the object","type":"string","enum":["active","disabled"]},"Tag":{"required":["name","definition"],"type":"object","properties":{"id":{"type":"integer"},"definition":{"type":"string","nullable":true,"description":"The description of the tag"},"name":{"type":"string"},"color":{"type":"string","nullable":true,"description":"The hex colour used when displaying the tag"},"status":{"$ref":"#/components/schemas/Status"},"tag_group_id":{"type":"integer","description":"The ID of the tag group this tag belongs to"},"created_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp when the tag was created"},"updated_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp when the tag was last modified"}},"example":{"id":1,"name":"Critical","definition":"Items that are critical to business operations","color":"#e0e0e0","status":"active","tag_group_id":1,"created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z"}},"TagRequest":{"type":"object","description":"Request body for creating or updating a tag.\n\nWhen creating a tag, `name` and `tag_group_id` are required. When updating, only include the fields you want to change.\n","required":["name","tag_group_id"],"properties":{"name":{"type":"string","description":"The name of the tag (must be unique within its tag group)","example":"Critical"},"definition":{"type":"string","nullable":true,"description":"The description of the tag","example":"Items that are critical to business operations"},"color":{"type":"string","nullable":true,"description":"The hex colour used when displaying the tag","example":"#e0e0e0"},"status":{"$ref":"#/components/schemas/Status"},"tag_group_id":{"type":"integer","description":"The ID of the tag group this tag belongs to. On update, moving a tag to a tag group in another workspace is not allowed.","example":1}}},"TagData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Tag"}},"required":["data"]},"TagMetadata":{"type":"object","properties":{"page":{"type":"integer","description":"The current page number"},"per_page":{"type":"integer","description":"The number of results per page"},"total_count":{"type":"integer","description":"The total number of tags matching the filter criteria"},"total_pages":{"type":"integer","description":"The total number of pages available"}},"required":["page","per_page","total_count","total_pages"]},"TagArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Tag"}},"metadata":{"$ref":"#/components/schemas/TagMetadata"}},"required":["data","metadata"]},"TagGroup":{"required":["name","definition","icon"],"type":"object","properties":{"id":{"type":"integer"},"definition":{"description":"Describes the purpose of this tag group","type":"string"},"name":{"description":"The group the tag belongs too","type":"string"},"slug":{"description":"The URL-friendly identifier generated from the name","type":"string"},"icon":{"description":"The icon that represents this Tag Group","type":"string"},"color":{"description":"The hex colour used when displaying this Tag Group","type":"string"},"tags":{"type":"array","items":{"$ref":"#/components/schemas/Tag"}},"status":{"$ref":"#/components/schemas/Status"},"created_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp when the tag group was created"},"updated_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp when the tag group was last modified"}},"example":{"id":1,"name":"Priority","slug":"priority","definition":"Tags that indicate the priority level of items","icon":"priority","color":"#e0e0e0","status":"active","created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z","tags":[{"id":1,"name":"Critical","definition":"Items that are critical to business operations","status":"active"},{"id":2,"name":"High","definition":"High priority items","status":"active"}]}},"TagGroupRequest":{"type":"object","description":"Request body for creating or updating a tag group.\n\nWhen creating a tag group, `name`, `definition`, and `icon` are required. When updating, only include the fields you want to change.\n\nSetting `status` to `disabled` also disables all tags in the group. Setting it back to `active` re-enables the group only; its tags stay disabled and must be re-enabled individually.\n","required":["name","definition","icon"],"properties":{"name":{"type":"string","description":"The name of the tag group (must be unique within your workspace)","example":"Priority"},"definition":{"type":"string","description":"Describes the purpose of this tag group","example":"Tags that indicate the priority level of items"},"icon":{"type":"string","description":"The icon that represents this Tag Group","example":"tags"},"color":{"type":"string","description":"The hex colour used when displaying this Tag Group","example":"#e0e0e0"},"status":{"$ref":"#/components/schemas/Status"}}},"TagGroupData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/TagGroup"}},"required":["data"]},"TagGroupArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TagGroup"}}}},"User":{"type":"object","properties":{"id":{"type":"integer"},"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string"}},"example":{"id":1,"first_name":"John","last_name":"Smith","email":"john.smith@example.com"}},"UserArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}},"Connection":{"type":"object","properties":{"start_id":{"type":"string","format":"uuid","description":"The UUID of the source topic in the relationship"},"start_type":{"type":"string","description":"The type of the source topic"},"end_id":{"type":"string","format":"uuid","description":"The UUID of the target topic in the relationship"},"end_type":{"type":"string","description":"The type of the target topic"},"adjective":{"type":"string","description":"The descriptive adjective for the relationship between the topics"}},"required":["start_id","start_type","end_id","end_type","adjective"],"example":{"start_id":"550e8400-e29b-41d4-a716-446655440000","start_type":"App","end_id":"660e8400-e29b-41d4-a716-446655440001","end_type":"Service","adjective":"uses"}},"Relation":{"type":"object","description":"A relationship between two Fact Cards, representing a typed connection such as a dependency, input, output, or other association.","properties":{"uuid":{"type":"string","format":"uuid","description":"The unique identifier (UUID) for this relation"},"source_uuid":{"type":"string","format":"uuid","description":"The UUID of the source Fact Card in the relationship"},"source_name":{"type":"string","description":"The name of the source Fact Card"},"source_type":{"type":"string","description":"The human-readable type of the source Fact Card (e.g., App, Technology, Process)"},"target_uuid":{"type":"string","format":"uuid","description":"The UUID of the target Fact Card in the relationship"},"target_name":{"type":"string","description":"The name of the target Fact Card"},"target_type":{"type":"string","description":"The human-readable type of the target Fact Card (e.g., App, Technology, Process)"},"relationship_name":{"type":"string","description":"The human-readable name of the relationship pattern (e.g., Depends on, Input, Output)"},"pattern":{"type":"string","description":"The machine-readable relationship pattern key (e.g., dependency, connection, input, output)"},"definition":{"type":"string","nullable":true,"description":"An optional description of this specific relationship"},"created_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp when the relation was created"},"updated_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp when the relation was last modified"}},"required":["uuid","source_uuid","source_name","source_type","target_uuid","target_name","target_type","relationship_name","pattern","created_at","updated_at"],"example":{"uuid":"770e8400-e29b-41d4-a716-446655440002","source_uuid":"550e8400-e29b-41d4-a716-446655440000","source_name":"Customer Portal","source_type":"App","target_uuid":"660e8400-e29b-41d4-a716-446655440001","target_name":"PostgreSQL","target_type":"Technology","relationship_name":"Depends on","pattern":"dependency","definition":null,"created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z"}},"RelationRequest":{"type":"object","description":"Request body for creating or updating a relation between two Fact Cards.\n\nWhen creating a relation, `source_uuid`, `target_uuid`, and `pattern` are required. When updating, only include the fields you want to change.\n","required":["source_uuid","target_uuid","pattern"],"properties":{"source_uuid":{"type":"string","format":"uuid","description":"The UUID of the source Fact Card","example":"550e8400-e29b-41d4-a716-446655440000"},"target_uuid":{"type":"string","format":"uuid","description":"The UUID of the target Fact Card","example":"660e8400-e29b-41d4-a716-446655440001"},"pattern":{"type":"string","description":"The relationship pattern key (e.g., dependency, connection, process_input, output). The relation reads \"<source> <verb> <target>\".\n\nTen patterns were replaced with new keys. Existing relations were migrated with source and target swapped. New relations using replaced patterns are rejected with HTTP 422, identifying the replacement: goal_strategy by strategy_goal, input by process_input, integration_provider by app_provided_integration, service_app by app_service, service_technology by technology_service, store by app_information, strategy_capability by capability_strategy, support by app_process, technology by app_capability, technology_2 by technology_capability.\n","example":"dependency"},"definition":{"type":"string","nullable":true,"description":"An optional description of this specific relationship","example":"The portal depends on PostgreSQL for data storage"}}},"RelationData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Relation"}},"required":["data"]},"RelationMetadata":{"type":"object","properties":{"page":{"type":"integer","description":"The current page number"},"per_page":{"type":"integer","description":"The number of results per page"},"total_count":{"type":"integer","description":"The total number of relations matching the filter criteria"},"total_pages":{"type":"integer","description":"The total number of pages available"}},"required":["page","per_page","total_count","total_pages"]},"RelationArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Relation"}},"metadata":{"$ref":"#/components/schemas/RelationMetadata"}},"required":["data","metadata"]},"ValueStage":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The UUID of the value stage"},"name":{"type":"string","description":"The name of the value stage"},"description":{"type":"string","nullable":true,"description":"The description of the value stage"},"position":{"type":"integer","description":"The position of the value stage within the group"},"width":{"type":"integer","description":"The column width of the value stage (1-12)"}},"required":["id","name","position","width"]},"ValueStageRequest":{"type":"object","description":"Attributes for creating, updating, or removing a value stage on a root group","properties":{"id":{"type":"string","format":"uuid","description":"The UUID of an existing value stage to update or remove (omit to create a new one)"},"name":{"type":"string","description":"The name of the value stage"},"description":{"type":"string","nullable":true,"description":"The description of the value stage"},"position":{"type":"integer","description":"The position of the value stage within the group"},"width":{"type":"integer","description":"The column width of the value stage (1-12)"},"_destroy":{"type":"boolean","description":"Set to true (with an id) to remove the value stage"}}},"Group":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The UUID of the group"},"name":{"type":"string","description":"The name of the group"},"aliases":{"type":"string","nullable":true,"description":"Alternative names for the group"},"definition":{"type":"string","nullable":true,"description":"The definition or description of the group"},"type":{"type":"string","description":"The type of group (e.g., CapabilityGroup, TechnologyGroup)","example":"CapabilityGroup"},"ancestry_depth":{"type":"integer","description":"The depth in the group hierarchy","example":0},"status":{"type":"string","enum":["active","disabled"],"description":"The status of the group"},"parent_id":{"type":"string","format":"uuid","nullable":true,"description":"The UUID of the parent group, if any"},"value_stages":{"type":"array","description":"The value stages of the group (only present on root groups)","items":{"$ref":"#/components/schemas/ValueStage"}},"created_at":{"type":"string","format":"date-time","description":"The date the group was created"},"updated_at":{"type":"string","format":"date-time","description":"The date the group was last updated"}},"required":["id","name","type","ancestry_depth","status","created_at","updated_at"],"example":{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Customer Experience","aliases":"CX, Customer Success","definition":"Groups related to customer experience capabilities","type":"CapabilityGroup","ancestry_depth":0,"status":"active","parent_id":null,"created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z"}},"GroupMetadata":{"type":"object","properties":{"limit":{"type":"integer","description":"The limit applied to the query, after clamping"},"offset":{"type":"integer","description":"The offset applied to the query, after clamping"},"total_count":{"type":"integer","description":"The total number of groups matching the filter criteria, independent of the page returned"}},"required":["limit","offset","total_count"]},"GroupArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Group"}},"metadata":{"$ref":"#/components/schemas/GroupMetadata"}},"required":["data","metadata"]},"GroupData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Group"}},"required":["data"]},"GroupCreateRequest":{"type":"object","required":["name","type"],"properties":{"name":{"type":"string","description":"The name of the group"},"type":{"type":"string","description":"The type of group (e.g., CapabilityGroup, TechnologyGroup)"},"aliases":{"type":"string","nullable":true,"description":"Alternative names for the group"},"definition":{"type":"string","nullable":true,"description":"The definition or description of the group"},"parent_id":{"type":"string","format":"uuid","nullable":true,"description":"The UUID of the parent group"},"value_stages_attributes":{"type":"array","description":"Value stages to create on the group. Only permitted on root groups (those without a parent).","items":{"$ref":"#/components/schemas/ValueStageRequest"}}}},"GroupUpdateRequest":{"type":"object","properties":{"name":{"type":"string","description":"The name of the group"},"aliases":{"type":"string","nullable":true,"description":"Alternative names for the group"},"definition":{"type":"string","nullable":true,"description":"The definition or description of the group"},"parent_id":{"type":"string","format":"uuid","nullable":true,"description":"The UUID of the parent group"},"value_stages_attributes":{"type":"array","description":"Value stages to create, update, or remove on the group. Only permitted on root groups (those without a parent). Include an id to update or remove an existing stage, or _destroy: true to remove it.","items":{"$ref":"#/components/schemas/ValueStageRequest"}}}},"ViewCollectionSummary":{"type":"object","description":"A collection views are filed under.","properties":{"id":{"type":"string","format":"uuid","description":"The UUID of the collection"},"name":{"type":"string","description":"The name of the collection"},"title":{"type":"string","description":"The heading shown above the collection"},"subtitle":{"type":"string","description":"The supporting text shown under the collection heading"},"status":{"type":"string","enum":["draft","request","published"],"description":"The status of the collection"}},"required":["id","name","title","subtitle","status"]},"ViewCollectionArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ViewCollectionSummary"}}},"required":["data"]},"View":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The UUID of the view"},"name":{"type":"string","description":"The name of the view"},"slug":{"type":"string","description":"The URL segment the view is addressed by in the app. Derived from the name, so use the id as a stable handle."},"definition":{"type":"string","nullable":true,"description":"The definition or description of the view"},"featured":{"type":"boolean","description":"Whether the view is highlighted in the app"},"visibility":{"type":"string","enum":["draft","published","shared"],"description":"Who can see the view: `draft` is private to its manager, `published` is visible to the whole organisation, and `shared` is visible to explicitly granted members and teams."},"status":{"type":"string","enum":["active","disabled"],"description":"The status of the view"},"published_at":{"type":"string","format":"date-time","nullable":true,"description":"When the view was first published, or null if it never has been"},"layout":{"type":"string","description":"The canvas the view is built on. An extended canvas joins the group and Fact Card types with a double underscore.","example":"CapabilityGroup__FactCard::Capability"},"base_panel_type":{"type":"string","description":"The group type rendered as the panels of the canvas","example":"CapabilityGroup"},"extended_panel_type":{"type":"string","nullable":true,"description":"The Fact Card type rendered inside the panels, or null for a group-only canvas","example":"FactCard::Capability"},"managed_by_user_id":{"type":"integer","nullable":true,"description":"The user who manages the view. Drafts and shared views are private to their manager."},"view_collections":{"type":"array","description":"The collections the view is filed under. Published views belong to at least one.","items":{"$ref":"#/components/schemas/ViewCollectionSummary"}},"created_at":{"type":"string","format":"date-time","description":"The date the view was created"},"updated_at":{"type":"string","format":"date-time","description":"The date the view was last updated"}},"required":["id","name","slug","featured","visibility","status","layout","base_panel_type","view_collections","created_at","updated_at"],"example":{"id":"550e8400-e29b-41d4-a716-446655440000","name":"Capability Model","slug":"capability-model","definition":"How our capabilities are organised","featured":false,"visibility":"published","status":"active","published_at":"2024-01-20T14:45:00Z","layout":"CapabilityGroup__FactCard::Capability","base_panel_type":"CapabilityGroup","extended_panel_type":"FactCard::Capability","managed_by_user_id":42,"view_collections":[],"created_at":"2024-01-15T10:30:00Z","updated_at":"2024-01-20T14:45:00Z"}},"ViewMetadata":{"type":"object","properties":{"limit":{"type":"integer","description":"The limit applied to the query, after clamping"},"offset":{"type":"integer","description":"The offset applied to the query, after clamping"},"total_count":{"type":"integer","description":"The total number of views matching the filter criteria, independent of the page returned"}},"required":["limit","offset","total_count"]},"ViewArray":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/View"}},"metadata":{"$ref":"#/components/schemas/ViewMetadata"}},"required":["data","metadata"]},"ViewData":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/View"}},"required":["data"]},"ViewCreateRequest":{"type":"object","required":["name","definition","layout"],"properties":{"name":{"type":"string","description":"The name of the view. The slug is derived from it."},"layout":{"type":"string","description":"The canvas to build the view on. Must be one of the canvases enabled for the workspace: `<TopicType>Group` for a group-only canvas, or `<TopicType>Group__FactCard::<TopicType>` for an extended canvas that also renders Fact Cards.","example":"CapabilityGroup__FactCard::Capability"},"user_id":{"type":"integer","description":"The member the view is created on behalf of. They author its first version and become its manager. Required when authenticating with an API key; OAuth tokens default to the authorising user."},"definition":{"type":"string","description":"What the view is for. Required."},"featured":{"type":"boolean","description":"Whether to highlight the view in the app"},"visibility":{"type":"string","enum":["draft","published"],"description":"Defaults to `draft`, which keeps the view private to its manager. `published` makes it visible to the whole organisation and requires at least one collection. Sharing with specific members or teams is done in the app."},"view_collection_ids":{"type":"array","description":"The collections to file the view under. Required when publishing.","items":{"type":"string","format":"uuid"}}}}},"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"Token","description":"Authentication is performed using a Bearer token in the Authorization header.\n\nTo authenticate your requests:\n\n1. Generate an API key from your workspace settings\n2. Include the token in the Authorization header: `Authorization: Bearer YOUR_API_KEY`\n\nAPI keys are scoped to your workspace and provide full access to all resources within that workspace. Keep your API keys secure and never commit them to version control.\n\n**Example:**\n```\ncurl -H \"Authorization: Bearer sk_live_...\" https://api.colloquial.io/api/v1/apps\n```\n"}}},"info":{"title":"Colloquial API","version":"1.0.0","description":"The Colloquial API provides programmatic access to your workspace data, enabling you to build integrations and automate workflows.\n\n## Authentication\n\nAll API requests must be authenticated using a Bearer token in the Authorization header. You can generate API keys from your workspace settings.\n\n## Base URL\n\nAll API requests should be made to `https://api.colloquial.io/api/v1`\n\n## Rate Limiting\n\nAPI requests are rate-limited to ensure fair usage. Rate limit headers are included in all responses.\n\n## Versioning\n\nThis API is versioned. The current version is v1. Breaking changes will be introduced in new major versions with appropriate deprecation notices.\n\n## Error Handling\n\nThe API uses standard HTTP status codes and returns detailed error messages in JSON format. All errors follow a consistent structure with descriptive messages to help you resolve issues quickly.\n\n## Pagination\n\nList endpoints are paginated, and every list response carries a `metadata` object describing the page. Two styles are in use:\n\n- **`page` / `per_page`** — the default, used by Fact Cards, Facts, Tags and Relations. `metadata` reports `page`, `per_page`, `total_count` and `total_pages`.\n- **`limit` / `offset`** — used by `/groups` and `/views`. `metadata` reports `limit`, `offset` and `total_count`.\n\nIn both styles `total_count` reports the full number of matching records, including when the requested page is past the end, so you can keep paging until you have seen that many.\n\n## Fact Cards\n\nFact Cards are the core entities in Colloquial, representing various business concepts like Apps, Services, Capabilities, and more. Each Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards.\n","termsOfService":"https://www.colloquial.io/terms/","contact":{"name":"Colloquial API Support","email":"support@colloquial.io","url":"https://help.colloquial.io"}},"tags":[{"name":"Apps","description":"Manage App Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach App Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Assets","description":"Manage Asset Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Asset Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Capabilities","description":"Manage Capability Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Capability Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Data","description":"Manage Data Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Data Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Features","description":"Manage Feature Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Feature Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Goals","description":"Manage Goal Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Goal Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Information","description":"Manage Information Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Information Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Influences","description":"Manage Influence Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Influence Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Integrations","description":"Manage Integration Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Integration Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Initiatives","description":"Manage Initiative Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Initiative Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Processes","description":"Manage Process Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Process Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Products","description":"Manage Product Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Product Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Services","description":"Manage Service Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Service Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Stakeholders","description":"Manage Stakeholder Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Stakeholder Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Strategies","description":"Manage Strategy Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Strategy Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Technologies","description":"Manage Technology Fact Cards in your workspace. Fact Cards represent core business entities and can be created, retrieved, updated, and deleted through these endpoints.\n\nEach Technology Fact Card can have associated facts (numbers, dates, choices, etc.) and connections to other Fact Cards, enabling you to build a comprehensive model of your business architecture.\n"},{"name":"Groups","description":"Manage hierarchical groups in your workspace. Groups are used to organise and categorise Fact Cards and other entities.\n\nGroups support parent-child relationships, allowing you to build taxonomies and hierarchies. Use these endpoints to retrieve group information and explore the structure of your workspace.\n"},{"name":"Relations","description":"Manage relationships between Fact Cards in your workspace. Relations represent typed connections between entities, such as dependencies, inputs, outputs, and more.\n\nUse these endpoints to create, retrieve, update, and delete relationships between Fact Cards. Results can be filtered by one or more Fact Card types or by relationship pattern.\n"},{"name":"Tags","description":"Manage tag groups and tags in your workspace. Tags provide a flexible way to categorise and filter Fact Cards.\n\nTag groups organise related tags together, making it easier to manage large sets of tags. Use these endpoints to retrieve tag information for filtering and categorisation purposes.\n"},{"name":"Templates","description":"Browse, create, and update the fact templates in your workspace. Templates define the facts a Fact Card can carry, and each is marked required, recommended, or optional for the topic types it applies to.\n\nUse the catalogue to discover what a Fact Card of a given type should have, and to obtain the `template_id`, `response_type`, and value hint needed to create facts. Templates are filed under Fact Groups, listed by `/template_groups`.\n"},{"name":"Users","description":"Retrieve user information for your workspace. These endpoints provide access to basic user details including names and email addresses.\n\nUser management (creating, updating, deleting users) is handled through the workspace administration interface, not through the API.\n"},{"name":"Views","description":"List and create views, and list the collections they are filed under. A view is a canvas that arranges the groups (and, on extended canvases, the Fact Cards) of your workspace into a picture of your architecture.\n\nEvery view is built on a `layout` — the canvas it renders. Newly created views start with every root group visible; narrowing the canvas, adding overlays, and sharing with specific people or teams are done in the app.\n\nBecause an API key is a workspace credential rather than a user, listings cover every view in the workspace, and creation requires a `user_id` naming the member the view belongs to.\n"}],"paths":{"/apps":{"get":{"summary":"list apps","tags":["Apps"],"operationId":"listApps","description":"Retrieve a list of all apps in your workspace. Returns an array of apps with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"apps exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create app","tags":["Apps"],"operationId":"createApp","description":"Create a new app in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The app will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The app fact card to create"}}},"/apps/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the app. This is returned in the `id` field when you create or retrieve a app.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show app","tags":["Apps"],"operationId":"getApp","description":"Retrieve the complete details for a specific app by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update app","tags":["Apps"],"operationId":"updateApp","description":"Update an existing app by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated app data"}},"delete":{"summary":"delete app","tags":["Apps"],"operationId":"deleteApp","description":"Permanently delete a app from your workspace by its UUID. This action cannot be undone. The app and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/assets":{"get":{"summary":"list assets","tags":["Assets"],"operationId":"listAssets","description":"Retrieve a list of all assets in your workspace. Returns an array of assets with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"assets exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create asset","tags":["Assets"],"operationId":"createAsset","description":"Create a new asset in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The asset will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The asset fact card to create"}}},"/assets/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the asset. This is returned in the `id` field when you create or retrieve a asset.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show asset","tags":["Assets"],"operationId":"getAsset","description":"Retrieve the complete details for a specific asset by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update asset","tags":["Assets"],"operationId":"updateAsset","description":"Update an existing asset by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated asset data"}},"delete":{"summary":"delete asset","tags":["Assets"],"operationId":"deleteAsset","description":"Permanently delete a asset from your workspace by its UUID. This action cannot be undone. The asset and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/capabilities":{"get":{"summary":"list capabilities","tags":["Capabilities"],"operationId":"listCapabilities","description":"Retrieve a list of all capabilities in your workspace. Returns an array of capabilities with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"capabilities exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create capability","tags":["Capabilities"],"operationId":"createCapability","description":"Create a new capability in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The capability will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The capability fact card to create"}}},"/capabilities/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the capability. This is returned in the `id` field when you create or retrieve a capability.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show capability","tags":["Capabilities"],"operationId":"getCapability","description":"Retrieve the complete details for a specific capability by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update capability","tags":["Capabilities"],"operationId":"updateCapability","description":"Update an existing capability by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated capability data"}},"delete":{"summary":"delete capability","tags":["Capabilities"],"operationId":"deleteCapability","description":"Permanently delete a capability from your workspace by its UUID. This action cannot be undone. The capability and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/data":{"get":{"summary":"list data","tags":["Data"],"operationId":"listData","description":"Retrieve a list of all data in your workspace. Returns an array of data with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"data exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create data","tags":["Data"],"operationId":"createData","description":"Create a new data in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The data will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The data fact card to create"}}},"/data/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the data. This is returned in the `id` field when you create or retrieve a data.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show data","tags":["Data"],"operationId":"getData","description":"Retrieve the complete details for a specific data by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update data","tags":["Data"],"operationId":"updateData","description":"Update an existing data by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated data data"}},"delete":{"summary":"delete data","tags":["Data"],"operationId":"deleteData","description":"Permanently delete a data from your workspace by its UUID. This action cannot be undone. The data and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/fact_templates":{"get":{"summary":"list fact templates","tags":["Templates"],"operationId":"listFactTemplates","description":"The supplied `topic_type` is not a recognised topic type.","security":[{"bearer":[]}],"parameters":[{"name":"topic_type","in":"query","required":false,"description":"Restrict the catalogue to templates that apply to this topic type, using the plural resource name (e.g. `capabilities`, `technologies`). Omit to list every template in the workspace.","schema":{"type":"string"},"example":"capabilities"}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactTemplateArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unknown topic type","content":{"application/json":{"examples":{"unknown topic type":{"value":{"errors":["Unknown topic_type 'widgets'"],"valid_topic_types":["capabilities","technologies","apps"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/facts":{"get":{"summary":"list facts","tags":["Facts"],"operationId":"listFacts","description":"Returns the facts for the Fact Card","security":[{"bearer":[]}],"parameters":[{"name":"topic_id","in":"query","required":false,"description":"Filter to a single Fact Card (topic) by UUID. Omit to list across the workspace.","schema":{"type":"string","format":"uuid"}},{"name":"response_type","in":"query","required":false,"description":"Restrict the results to a single response type","schema":{"type":"string","enum":["calculated","choice","currency","date","date_range","external","link_with_status","multistep","number","quadrant","rich_text","stakeholder","unrestricted"]}},{"name":"template_id","in":"query","required":false,"description":"Filter to a single template by uuid. Implies its response_type; if response_type is also given it must match. Deprecated: a legacy integer template id is still accepted together with response_type.","schema":{"type":"string","format":"uuid"},"example":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c0d"},{"name":"state","in":"query","required":false,"description":"Filter by state (matching the `state` field): future, in_effect, expired, superseded, ignored, or all (alias: any). Omit to list the live (non-superseded, non-ignored) facts across all periods. Compound facts (calculated, quadrant) require a topic and are excluded from superseded/ignored.","schema":{"type":"string","enum":["future","in_effect","expired","superseded","ignored","all"]}},{"name":"page","in":"query","required":false,"description":"Page number (default 1)","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Results per page (default 25, max 100)","schema":{"type":"integer"},"example":25}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create fact","tags":["Facts"],"operationId":"createFact","description":"The topic, template, or user could not be found in your workspace/organisation","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactRequest"},"examples":{"number":{"summary":"Number (detail answer)","value":{"topic_id":"550e8400-e29b-41d4-a716-446655440000","response_type":"number","template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c01","user_id":1,"value":{"response":"42"}}},"currency":{"summary":"Currency (detail answer)","value":{"topic_id":"550e8400-e29b-41d4-a716-446655440000","response_type":"currency","template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c02","user_id":1,"value":{"response":"50000.00"}}},"choice":{"summary":"Choice (assessment)","value":{"topic_id":"550e8400-e29b-41d4-a716-446655440000","response_type":"choice","template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c03","user_id":1,"justification":"Reviewed in Q2","value":{"scale_value_id":7}}},"multistep":{"summary":"Multistep (assessment)","value":{"topic_id":"550e8400-e29b-41d4-a716-446655440000","response_type":"multistep","template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c04","user_id":1,"value":{"score":3.2}}},"link_with_status":{"summary":"Link (link with status)","value":{"topic_id":"550e8400-e29b-41d4-a716-446655440000","response_type":"link_with_status","template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c05","user_id":1,"value":{"href":"https://example.com/runbook","status":"approved"}}},"stakeholder":{"summary":"Stakeholder (partnership)","value":{"topic_id":"550e8400-e29b-41d4-a716-446655440000","response_type":"stakeholder","template_id":"7f3c9a52-1d4e-4b8a-9c2f-5e6d7a8b9c06","user_id":1,"value":{"stakeholder":"660e8400-e29b-41d4-a716-446655440001","role":"Owner"}}}}}},"required":true,"description":"The fact to create"}}},"/facts/{response_type}/{id}":{"parameters":[{"name":"response_type","in":"path","required":true,"description":"The response type of the fact (disambiguates the underlying record). Compound types (calculated, quadrant) are not individually addressable.","schema":{"type":"string","enum":["choice","currency","date","date_range","external","link_with_status","multistep","number","rich_text","stakeholder","unrestricted"]}},{"name":"id","in":"path","required":true,"description":"The fact identifier (UUID or numeric id depending on response_type).","schema":{"type":"string"}}],"get":{"summary":"show fact","tags":["Facts"],"operationId":"getFact","description":"Returns the fact","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"renew fact","tags":["Facts"],"operationId":"renewFact","description":"The fact was renewed (a freshly-dated copy supersedes the original)","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["user_id"],"properties":{"user_id":{"type":"integer","description":"The id of the user credited as the contributor (must be an active member of the organisation)"}}}}},"required":true,"description":"The contributor to credit for the renewal"}}},"/features":{"get":{"summary":"list features","tags":["Features"],"operationId":"listFeatures","description":"Retrieve a list of all features in your workspace. Returns an array of features with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"features exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create feature","tags":["Features"],"operationId":"createFeature","description":"Create a new feature in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The feature will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The feature fact card to create"}}},"/features/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the feature. This is returned in the `id` field when you create or retrieve a feature.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show feature","tags":["Features"],"operationId":"getFeature","description":"Retrieve the complete details for a specific feature by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update feature","tags":["Features"],"operationId":"updateFeature","description":"Update an existing feature by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated feature data"}},"delete":{"summary":"delete feature","tags":["Features"],"operationId":"deleteFeature","description":"Permanently delete a feature from your workspace by its UUID. This action cannot be undone. The feature and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/goals":{"get":{"summary":"list goals","tags":["Goals"],"operationId":"listGoals","description":"Retrieve a list of all goals in your workspace. Returns an array of goals with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"goals exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create goal","tags":["Goals"],"operationId":"createGoal","description":"Create a new goal in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The goal will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The goal fact card to create"}}},"/goals/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the goal. This is returned in the `id` field when you create or retrieve a goal.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show goal","tags":["Goals"],"operationId":"getGoal","description":"Retrieve the complete details for a specific goal by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update goal","tags":["Goals"],"operationId":"updateGoal","description":"Update an existing goal by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated goal data"}},"delete":{"summary":"delete goal","tags":["Goals"],"operationId":"deleteGoal","description":"Permanently delete a goal from your workspace by its UUID. This action cannot be undone. The goal and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/groups":{"get":{"summary":"list groups","tags":["Groups"],"description":"Returns an empty array when no groups exist","security":[{"bearer":[]}],"parameters":[{"name":"type","in":"query","required":false,"description":"Filter groups by type (e.g., CapabilityGroup, TechnologyGroup)","schema":{"type":"string"},"example":"CapabilityGroup"},{"name":"limit","in":"query","required":false,"description":"Maximum number of groups to return (default: 100, clamped to 1..1000). A blank or non-numeric value falls back to the default.","schema":{"type":"integer"},"example":100},{"name":"offset","in":"query","required":false,"description":"Number of groups to skip for pagination (default: 0, clamped to 0 or above)","schema":{"type":"integer"},"example":0}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create group","tags":["Groups"],"description":"Value stages can only be managed on root groups","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"group created with value stages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupCreateRequest"}}},"required":true}}},"/groups/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The UUID of the group","schema":{"type":"string"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show group","tags":["Groups"],"operationId":"getGroup","description":"Returns the complete group details","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update group","tags":["Groups"],"description":"Add, modify, and remove value stages on a root group","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"group updated with value stages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupUpdateRequest"}}},"required":true}},"delete":{"summary":"delete group","tags":["Groups"],"description":"Delete a group","security":[{"bearer":[]}],"responses":{"204":{"description":"group deleted"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}},"409":{"description":"group has child groups"}}}},"/influences":{"get":{"summary":"list influences","tags":["Influences"],"operationId":"listInfluences","description":"Retrieve a list of all influences in your workspace. Returns an array of influences with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"influences exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create influence","tags":["Influences"],"operationId":"createInfluence","description":"Create a new influence in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The influence will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The influence fact card to create"}}},"/influences/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the influence. This is returned in the `id` field when you create or retrieve a influence.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show influence","tags":["Influences"],"operationId":"getInfluence","description":"Retrieve the complete details for a specific influence by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update influence","tags":["Influences"],"operationId":"updateInfluence","description":"Update an existing influence by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated influence data"}},"delete":{"summary":"delete influence","tags":["Influences"],"operationId":"deleteInfluence","description":"Permanently delete a influence from your workspace by its UUID. This action cannot be undone. The influence and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/information":{"get":{"summary":"list information","tags":["Information"],"operationId":"listInformation","description":"Retrieve a list of all information in your workspace. Returns an array of information with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"information exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create information","tags":["Information"],"operationId":"createInformation","description":"Create a new information in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The information will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The information fact card to create"}}},"/information/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the information. This is returned in the `id` field when you create or retrieve a information.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show information","tags":["Information"],"operationId":"getInformation","description":"Retrieve the complete details for a specific information by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update information","tags":["Information"],"operationId":"updateInformation","description":"Update an existing information by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated information data"}},"delete":{"summary":"delete information","tags":["Information"],"operationId":"deleteInformation","description":"Permanently delete a information from your workspace by its UUID. This action cannot be undone. The information and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/initiatives":{"get":{"summary":"list initiatives","tags":["Initiatives"],"operationId":"listInitiatives","description":"Retrieve a list of all initiatives in your workspace. Returns an array of initiatives with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"initiatives exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create initiative","tags":["Initiatives"],"operationId":"createInitiative","description":"Create a new initiative in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The initiative will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The initiative fact card to create"}}},"/initiatives/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the initiative. This is returned in the `id` field when you create or retrieve a initiative.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show initiative","tags":["Initiatives"],"operationId":"getInitiative","description":"Retrieve the complete details for a specific initiative by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update initiative","tags":["Initiatives"],"operationId":"updateInitiative","description":"Update an existing initiative by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated initiative data"}},"delete":{"summary":"delete initiative","tags":["Initiatives"],"operationId":"deleteInitiative","description":"Permanently delete a initiative from your workspace by its UUID. This action cannot be undone. The initiative and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/integrations":{"get":{"summary":"list integrations","tags":["Integrations"],"operationId":"listIntegrations","description":"Retrieve a list of all integrations in your workspace. Returns an array of integrations with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"integrations exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create integration","tags":["Integrations"],"operationId":"createIntegration","description":"Create a new integration in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The integration will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The integration fact card to create"}}},"/integrations/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the integration. This is returned in the `id` field when you create or retrieve a integration.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show integration","tags":["Integrations"],"operationId":"getIntegration","description":"Retrieve the complete details for a specific integration by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update integration","tags":["Integrations"],"operationId":"updateIntegration","description":"Update an existing integration by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated integration data"}},"delete":{"summary":"delete integration","tags":["Integrations"],"operationId":"deleteIntegration","description":"Permanently delete a integration from your workspace by its UUID. This action cannot be undone. The integration and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/processes":{"get":{"summary":"list processes","tags":["Processes"],"operationId":"listProcesses","description":"Retrieve a list of all processes in your workspace. Returns an array of processes with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"processes exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create process","tags":["Processes"],"operationId":"createProcess","description":"Create a new process in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The process will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The process fact card to create"}}},"/processes/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the process. This is returned in the `id` field when you create or retrieve a process.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show process","tags":["Processes"],"operationId":"getProcess","description":"Retrieve the complete details for a specific process by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update process","tags":["Processes"],"operationId":"updateProcess","description":"Update an existing process by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated process data"}},"delete":{"summary":"delete process","tags":["Processes"],"operationId":"deleteProcess","description":"Permanently delete a process from your workspace by its UUID. This action cannot be undone. The process and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/products":{"get":{"summary":"list products","tags":["Products"],"operationId":"listProducts","description":"Retrieve a list of all products in your workspace. Returns an array of products with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"products exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create product","tags":["Products"],"operationId":"createProduct","description":"Create a new product in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The product will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The product fact card to create"}}},"/products/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the product. This is returned in the `id` field when you create or retrieve a product.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show product","tags":["Products"],"operationId":"getProduct","description":"Retrieve the complete details for a specific product by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update product","tags":["Products"],"operationId":"updateProduct","description":"Update an existing product by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated product data"}},"delete":{"summary":"delete product","tags":["Products"],"operationId":"deleteProduct","description":"Permanently delete a product from your workspace by its UUID. This action cannot be undone. The product and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/relations":{"get":{"summary":"list relations","tags":["Relations"],"operationId":"listRelations","description":"Returns an empty array when no relations exist","security":[{"bearer":[]}],"parameters":[{"name":"types","in":"query","required":false,"description":"Filter relations where the source or target matches one of the specified Fact Card types. Accepts multiple values (e.g., types=apps&types=technologies).","schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"example":["apps","technologies"]},{"name":"pattern","in":"query","required":false,"description":"Filter relations by relationship pattern (e.g., dependency, connection, input, output)","schema":{"type":"string"},"example":"dependency"},{"name":"page","in":"query","required":false,"description":"Page number for pagination (default: 1)","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Number of results per page (default: 25, max: 100)","schema":{"type":"integer"},"example":25}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create relation","tags":["Relations"],"operationId":"createRelation","description":"Validation failed (e.g., missing pattern, duplicate relation, or invalid Fact Card UUIDs)","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Source or target Fact Card not found"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationRequest"}}},"required":true,"description":"The relation to create"}}},"/relations/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the relation.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show relation","tags":["Relations"],"operationId":"getRelation","description":"Returns the relation details","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update relation","tags":["Relations"],"operationId":"updateRelation","description":"The relation was successfully updated","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Pattern can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RelationRequest"}}},"required":true,"description":"The updated relation data"}},"delete":{"summary":"delete relation","tags":["Relations"],"operationId":"deleteRelation","description":"The relation was successfully deleted","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}}}}}}}}},"/services":{"get":{"summary":"list services","tags":["Services"],"operationId":"listServices","description":"Retrieve a list of all services in your workspace. Returns an array of services with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"services exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create service","tags":["Services"],"operationId":"createService","description":"Create a new service in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The service will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The service fact card to create"}}},"/services/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the service. This is returned in the `id` field when you create or retrieve a service.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show service","tags":["Services"],"operationId":"getService","description":"Retrieve the complete details for a specific service by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update service","tags":["Services"],"operationId":"updateService","description":"Update an existing service by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated service data"}},"delete":{"summary":"delete service","tags":["Services"],"operationId":"deleteService","description":"Permanently delete a service from your workspace by its UUID. This action cannot be undone. The service and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/stakeholders":{"get":{"summary":"list stakeholders","tags":["Stakeholders"],"operationId":"listStakeholders","description":"Retrieve a list of all stakeholders in your workspace. Returns an array of stakeholders with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"stakeholders exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create stakeholder","tags":["Stakeholders"],"operationId":"createStakeholder","description":"Create a new stakeholder in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The stakeholder will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderRequest"}}},"required":true,"description":"The stakeholder fact card to create"}}},"/stakeholders/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the stakeholder. This is returned in the `id` field when you create or retrieve a stakeholder.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show stakeholder","tags":["Stakeholders"],"operationId":"getStakeholder","description":"Retrieve the complete details for a specific stakeholder by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update stakeholder","tags":["Stakeholders"],"operationId":"updateStakeholder","description":"Update an existing stakeholder by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StakeholderRequest"}}},"required":true,"description":"The updated stakeholder data"}},"delete":{"summary":"delete stakeholder","tags":["Stakeholders"],"operationId":"deleteStakeholder","description":"Permanently delete a stakeholder from your workspace by its UUID. This action cannot be undone. The stakeholder and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/strategies":{"get":{"summary":"list strategies","tags":["Strategies"],"operationId":"listStrategies","description":"Retrieve a list of all strategies in your workspace. Returns an array of strategies with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"strategies exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create strategy","tags":["Strategies"],"operationId":"createStrategy","description":"Create a new strategy in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The strategy will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The strategy fact card to create"}}},"/strategies/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the strategy. This is returned in the `id` field when you create or retrieve a strategy.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show strategy","tags":["Strategies"],"operationId":"getStrategy","description":"Retrieve the complete details for a specific strategy by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update strategy","tags":["Strategies"],"operationId":"updateStrategy","description":"Update an existing strategy by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated strategy data"}},"delete":{"summary":"delete strategy","tags":["Strategies"],"operationId":"deleteStrategy","description":"Permanently delete a strategy from your workspace by its UUID. This action cannot be undone. The strategy and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/tag_groups":{"get":{"summary":"list tag groups","tags":["Tags"],"operationId":"listTagGroups","description":"Returns an empty array when no tag groups exist","security":[{"bearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"description":"Filter tag groups by status. Defaults to `active`, which also hides disabled tags inside each group. Use `disabled` to list disabled groups, or `all` to list every group and tag regardless of status.","schema":{"type":"string","enum":["active","disabled","all"]},"example":"all"}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagGroupArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create tag group","tags":["Tags"],"operationId":"createTagGroup","description":"Validation failed (e.g., missing name, definition, or icon, or a duplicate name)","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagGroupData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Definition can't be blank","Icon can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagGroupRequest"}}},"required":true,"description":"The tag group to create"}}},"/tag_groups/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier of the tag group.","schema":{"type":"integer"},"example":1}],"get":{"summary":"show tag group","tags":["Tags"],"operationId":"getTagGroup","description":"Returns the tag group details","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagGroupData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update tag group","tags":["Tags"],"operationId":"updateTagGroup","description":"The tag group was successfully updated","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagGroupData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagGroupRequest"}}},"required":true,"description":"The updated tag group data"}},"delete":{"summary":"delete tag group","tags":["Tags"],"operationId":"deleteTagGroup","description":"The tag group was successfully deleted","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/tags":{"get":{"summary":"list tags","tags":["Tags"],"operationId":"listTags","description":"Returns an empty array when no tags exist","security":[{"bearer":[]}],"parameters":[{"name":"tag_group_id","in":"query","required":false,"description":"Filter tags by the tag group they belong to","schema":{"type":"integer"},"example":1},{"name":"status","in":"query","required":false,"description":"Filter tags by status. By default tags of every status are returned.","schema":{"type":"string","enum":["active","disabled"]},"example":"active"},{"name":"page","in":"query","required":false,"description":"Page number for pagination (default: 1)","schema":{"type":"integer"},"example":1},{"name":"per_page","in":"query","required":false,"description":"Number of results per page (default: 25, max: 100)","schema":{"type":"integer"},"example":25}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create tag","tags":["Tags"],"operationId":"createTag","description":"Validation failed (e.g., missing name, duplicate name within the tag group, or an unknown tag group)","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Tag group not found"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagRequest"}}},"required":true,"description":"The tag to create"}}},"/tags/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier of the tag.","schema":{"type":"integer"},"example":1}],"get":{"summary":"show tag","tags":["Tags"],"operationId":"getTag","description":"Returns the tag details","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update tag","tags":["Tags"],"operationId":"updateTag","description":"The tag was successfully updated","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagRequest"}}},"required":true,"description":"The updated tag data"}},"delete":{"summary":"delete tag","tags":["Tags"],"operationId":"deleteTag","description":"The tag was successfully deleted","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/technologies":{"get":{"summary":"list technologies","tags":["Technologies"],"operationId":"listTechnologies","description":"Retrieve a list of all technologies in your workspace. Returns an array of technologies with their associated facts and connections.","security":[{"bearer":[]}],"responses":{"200":{"description":"technologies exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create technology","tags":["Technologies"],"operationId":"createTechnology","description":"Create a new technology in your workspace. You can optionally include aliases, descriptions, tags, and set the archived status. The technology will be created with a unique UUID and timestamps.","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank","Description is too short (minimum is 10 characters)"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The technology fact card to create"}}},"/technologies/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The unique identifier (UUID) of the technology. This is returned in the `id` field when you create or retrieve a technology.","schema":{"type":"string","format":"uuid"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show technology","tags":["Technologies"],"operationId":"getTechnology","description":"Retrieve the complete details for a specific technology by its UUID. This includes all fields, associated facts (numbers, dates, choices, etc.), and connections to other topics.","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"update technology","tags":["Technologies"],"operationId":"updateTechnology","description":"Update an existing technology by its UUID. You can update any combination of fields including name, aliases, description, tags, and archived status. Only the fields you provide will be updated (partial updates are supported).","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"partial update","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"validation errors":{"value":{"errors":["Name can't be blank"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactCardRequest"}}},"required":true,"description":"The updated technology data"}},"delete":{"summary":"delete technology","tags":["Technologies"],"operationId":"deleteTechnology","description":"Permanently delete a technology from your workspace by its UUID. This action cannot be undone. The technology and all its associated data will be removed.","security":[{"bearer":[]}],"responses":{"204":{"description":"no content"},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}}}}}}}},"/template_groups":{"get":{"summary":"list template groups","tags":["Templates"],"operationId":"listTemplateGroups","description":"Returns the Fact Groups templates are filed under, in display order. Pass an id as `template_group_id` when creating or updating a template.","security":[{"bearer":[]}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateGroupArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/templates":{"post":{"summary":"create template","tags":["Templates"],"operationId":"createTemplate","description":"The response type is not supported yet, or validation failed (e.g. a duplicate name).","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"examples":{"coming soon":{"value":{"errors":["response_type 'stakeholder' is coming soon to the API"],"supported_response_types":["unrestricted","number","date","currency","date_range","rich_text","choice"],"coming_soon_response_types":["multistep","calculated","link_with_status","quadrant","stakeholder"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateRequest"}}},"required":true,"description":"The template to create"}}},"/templates/{uuid}":{"parameters":[{"name":"uuid","in":"path","required":true,"description":"The template's uuid (`template_id` in the fact template catalogue).","schema":{"type":"string","format":"uuid"}}],"patch":{"summary":"update template","tags":["Templates"],"operationId":"updateTemplate","description":"Validation failed, e.g. an option id from another template or a duplicate name.","security":[{"bearer":[]}],"parameters":[],"responses":{"200":{"description":"updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"unprocessable entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateUpdateRequest"}}},"required":true,"description":"The changes to make"}}},"/users":{"get":{"summary":"list users","tags":["Users"],"operationId":"listUsers","description":"Retrieve all users in your workspace. This endpoint returns basic user information including name and email address for all users who have access to the workspace.","security":[{"bearer":[]}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/view_collections":{"get":{"summary":"list view collections","tags":["Views"],"operationId":"listViewCollections","description":"Returns the collections views can be filed under, in display order. Pass their ids as `view_collection_ids` when creating a view; a published view needs at least one.","security":[{"bearer":[]}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewCollectionArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/views":{"get":{"summary":"list views","tags":["Views"],"description":"Returns an empty array when no views exist","security":[{"bearer":[]}],"parameters":[{"name":"visibility","in":"query","required":false,"description":"Filter views by visibility (draft, published, or shared)","schema":{"type":"string","enum":["draft","published","shared"]},"example":"published"},{"name":"layout","in":"query","required":false,"description":"Filter views by the canvas they are built on","schema":{"type":"string"},"example":"CapabilityGroup__FactCard::Capability"},{"name":"limit","in":"query","required":false,"description":"Maximum number of views to return (default: 100, max: 1000)","schema":{"type":"integer"},"example":100},{"name":"offset","in":"query","required":false,"description":"Number of views to skip for pagination (default: 0)","schema":{"type":"integer"},"example":0}],"responses":{"200":{"description":"empty list","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewArray"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"create view","tags":["Views"],"description":"A published view must be filed into at least one collection","security":[{"bearer":[]}],"parameters":[],"responses":{"201":{"description":"published view created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"validation failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewCreateRequest"}}},"required":true}}},"/views/{id}":{"parameters":[{"name":"id","in":"path","required":true,"description":"The UUID of the view","schema":{"type":"string"},"example":"550e8400-e29b-41d4-a716-446655440000"}],"get":{"summary":"show view","tags":["Views"],"operationId":"getView","description":"Returns the complete view details","security":[{"bearer":[]}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewData"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"examples":{"unauthorized":{"value":{"errors":["Access denied"]}},"invalid_token":{"value":{"errors":["Invalid API key"]}},"missing_token":{"value":{"errors":["Authorization header required"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"not found","content":{"application/json":{"examples":{"not found":{"value":{"errors":["Not found"]}},"resource_deleted":{"value":{"errors":["Resource has been deleted"]}}},"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"servers":[{"url":"https://{defaultHost}","description":"Production","variables":{"defaultHost":{"default":"api.colloquial.io/api/v1"}}}]}