generated: '2026-10-04'
method: derived
generator: derive-data-model.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
- openapi/cognition-labs-openapi.yaml
- openapi/cognition-labs-organizations-v3-api-openapi.yml
- openapi/cognition-labs-playbooks-api-openapi.yml
- openapi/cognition-labs-secrets-api-openapi.yml
- openapi/cognition-labs-sessions-api-openapi.yml
notation: has_one = property $ref; has_many = array of $ref; belongs_to = <entity>_id field
summary:
  entities: 29
  entities_in_spec: 29
  relationships: 8
entities:
- name: AuditLog
  fields: 3
  description: Audit log entry
- name: ConsumptionCycle
  fields: 2
  description: Billing cycle information
- name: ConsumptionFilterParams
  fields: 2
  description: Parameters for filtering enterprise consumption data
- name: ConsumptionPullRequest
  fields: 2
  description: Pull request information
- name: ConsumptionSession
  fields: 9
  description: Session consumption data
- name: CreatePlaybookRequest
  fields: 3
  description: Request body for creating or updating a playbook
- name: CreateSecretRequest
  fields: 5
  description: Request body for creating a new secret
- name: CreateSessionInput
  fields: 12
- name: CreateSessionRequest
  fields: 9
  description: Request body for creating a new Devin session
- name: CreateSessionResponse
  fields: 3
  description: Response body returned when a session is successfully created
- name: EditSessionTagsRequest
  fields: 1
  description: Request body for updating session tags
- name: EnterpriseConsumptionResponse
  fields: 2
  description: Enterprise consumption data response
- name: GetSessionResponse
  fields: 12
  description: Detailed information about an existing session
- name: KnowledgeEntry
  fields: 0
- name: KnowledgeFolder
  fields: 4
- name: KnowledgeFolderResponse
  fields: 4
  description: Information about a knowledge folder
- name: KnowledgeInput
  fields: 6
- name: KnowledgeRequest
  fields: 5
  description: Information about a piece of knowledge
- name: KnowledgeResponse
  fields: 0
  description: Information about a piece of knowledge
- name: Message
  fields: 7
  description: A message in a Devin session
- name: Playbook
  fields: 0
- name: PlaybookInput
  fields: 4
- name: PlaybookResponse
  fields: 13
  description: Response object for playbook operations
- name: SecretInput
  fields: 5
- name: SecretMetadata
  fields: 4
  description: Metadata about a stored secret
- name: SendMessageRequest
  fields: 1
  description: Request body for sending a message to an existing Devin session
- name: SessionDetail
  fields: 0
- name: SessionSummary
  fields: 12
- name: ValidationErrorBody
  fields: 1
relationships:
- from: GetSessionResponse
  to: Playbook
  type: belongs_to
  via: playbook_id
- from: GetSessionResponse
  to: Message
  type: has_many
  via: messages
- from: EnterpriseConsumptionResponse
  to: ConsumptionSession
  type: has_many
  via: sessions
- from: EnterpriseConsumptionResponse
  to: ConsumptionCycle
  type: has_one
  via: cycle
- from: ConsumptionSession
  to: ConsumptionPullRequest
  type: has_many
  via: pull_requests
- from: PlaybookResponse
  to: Playbook
  type: belongs_to
  via: playbook_id
- from: CreateSessionInput
  to: Playbook
  type: belongs_to
  via: playbook_id
- from: SessionSummary
  to: Playbook
  type: belongs_to
  via: playbook_id