generated: '2026-10-04' method: derived generator: derive-vocabulary.py source: - openapi/cognition-labs-attachments-api-openapi.yml - openapi/cognition-labs-consumption-api-openapi.yml - openapi/cognition-labs-enterprise-v3-api-openapi.yml - openapi/cognition-labs-knowledge-api-openapi.yml - openapi/cognition-labs-messages-api-openapi.yml vocabulary: name: Cognition Labs Domain Vocabulary description: 'Terms declared by Cognition Labs''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions. Derived, not authored.' version: '2026-10-04' terms: - term: Attachments definition: Upload and download files for Devin to work with. tags: - Resource Group source: openapi/cognition-labs-attachments-api-openapi.yml - term: Consumption definition: Agent Compute Unit (ACU) usage and billing metrics. tags: - Resource Group source: openapi/cognition-labs-consumption-api-openapi.yml - term: Enterprise (v3) definition: Cross-organization administration. tags: - Resource Group source: openapi/cognition-labs-enterprise-v3-api-openapi.yml - term: Knowledge definition: Organization knowledge entries and folders. tags: - Resource Group source: openapi/cognition-labs-knowledge-api-openapi.yml - term: Messages definition: Send and read messages within a running session. tags: - Resource Group source: openapi/cognition-labs-messages-api-openapi.yml - term: Sessions definition: Operations for creating and managing Devin sessions tags: - Resource Group source: openapi/cognition-labs-openapi.yaml - term: Secrets definition: Operations for managing secrets and credentials tags: - Resource Group source: openapi/cognition-labs-openapi.yaml - term: AuditLogs definition: Operations for managing audit logs tags: - Resource Group source: openapi/cognition-labs-openapi.yaml - term: Enterprise definition: Operations for enterprise-specific features and reporting tags: - Resource Group source: openapi/cognition-labs-openapi.yaml - term: Playbooks definition: Operations for managing playbooks tags: - Resource Group source: openapi/cognition-labs-openapi.yaml - term: Organizations (v3) definition: Current org-scoped session and user management. tags: - Resource Group source: openapi/cognition-labs-organizations-v3-api-openapi.yml - term: ValidationErrorBody definition: 'Object declared by the contract with fields: detail.' tags: - Object source: openapi/cognition-labs-attachments-api-openapi.yml#/components/schemas/ValidationErrorBody - term: KnowledgeFolder definition: 'Object declared by the contract with fields: id, name, description, created_at.' tags: - Object source: openapi/cognition-labs-knowledge-api-openapi.yml#/components/schemas/KnowledgeFolder - term: KnowledgeInput definition: 'Object declared by the contract with fields: name, body, trigger_description, macro, parent_folder_id, pinned_repo.' tags: - Object source: openapi/cognition-labs-knowledge-api-openapi.yml#/components/schemas/KnowledgeInput - term: CreateSessionRequest definition: Request body for creating a new Devin session tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/CreateSessionRequest - term: CreateSessionResponse definition: Response body returned when a session is successfully created tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/CreateSessionResponse - term: Message definition: A message in a Devin session tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/Message - term: GetSessionResponse definition: Detailed information about an existing session tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/GetSessionResponse - term: SendMessageRequest definition: Request body for sending a message to an existing Devin session tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/SendMessageRequest - term: SecretMetadata definition: Metadata about a stored secret tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/SecretMetadata - term: CreateSecretRequest definition: Request body for creating a new secret tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/CreateSecretRequest - term: EditSessionTagsRequest definition: Request body for updating session tags tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/EditSessionTagsRequest - term: EnterpriseConsumptionResponse definition: Enterprise consumption data response tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/EnterpriseConsumptionResponse - term: ConsumptionSession definition: Session consumption data tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/ConsumptionSession - term: ConsumptionPullRequest definition: Pull request information tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/ConsumptionPullRequest - term: ConsumptionCycle definition: Billing cycle information tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/ConsumptionCycle - term: ConsumptionFilterParams definition: Parameters for filtering enterprise consumption data tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/ConsumptionFilterParams - term: AuditLog definition: Audit log entry tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/AuditLog - term: KnowledgeRequest definition: Information about a piece of knowledge tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/KnowledgeRequest - term: KnowledgeResponse definition: Information about a piece of knowledge tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/KnowledgeResponse - term: KnowledgeFolderResponse definition: Information about a knowledge folder tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/KnowledgeFolderResponse - term: CreatePlaybookRequest definition: Request body for creating or updating a playbook tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/CreatePlaybookRequest - term: PlaybookResponse definition: Response object for playbook operations tags: - Object source: openapi/cognition-labs-openapi.yaml#/components/schemas/PlaybookResponse - term: CreateSessionInput definition: 'Object declared by the contract with fields: prompt, title, snapshot_id, playbook_id, knowledge_ids, secret_ids, session_secrets, structured_output_schema, tags, max_acu_limit, idempotent, unlisted.' tags: - Object source: openapi/cognition-labs-organizations-v3-api-openapi.yml#/components/schemas/CreateSessionInput - term: PlaybookInput definition: 'Object declared by the contract with fields: title, body, macro, access_type.' tags: - Object source: openapi/cognition-labs-playbooks-api-openapi.yml#/components/schemas/PlaybookInput - term: SecretInput definition: 'Object declared by the contract with fields: type, key, value, sensitive, note.' tags: - Object source: openapi/cognition-labs-secrets-api-openapi.yml#/components/schemas/SecretInput - term: SessionSummary definition: 'Object declared by the contract with fields: session_id, status, status_enum, created_at, updated_at, title, requesting_user_email, playbook_id, snapshot_id, tags, pull_request, structured_output.' tags: - Object source: openapi/cognition-labs-sessions-api-openapi.yml#/components/schemas/SessionSummary - term: SessionStatusEnum definition: 'Enumeration declared by the contract with values: working, blocked, expired, finished, suspend_requested, suspend_requested_frontend, resume_requested, resume_requested_frontend, resumed.' tags: - Enumeration source: openapi/cognition-labs-sessions-api-openapi.yml#/components/schemas/SessionStatusEnum