> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get project timeline events > Returns project changes and sourced global facts as context for interpreting Visibility trends. Global facts are limited to all-platform events or platforms enabled for the project. Events do not imply a causal link to metric movements. ## OpenAPI ````yaml /openapi.json get /projects/{projectId}/timeline/events openapi: 3.1.0 info: title: DevTune API version: 2.0.0 description: >- API for programmatic access to your AI visibility data, webhook subscriptions, and automation workflows. Use this API to integrate DevTune data into CI/CD pipelines, BI tools, AI agents, and operational systems. servers: - url: https://devtune.ai/api/v2 description: Production security: - bearerAuth: [] paths: /projects/{projectId}/timeline/events: get: summary: Get project timeline events description: >- Returns project changes and sourced global facts as context for interpreting Visibility trends. Global facts are limited to all-platform events or platforms enabled for the project. Events do not imply a causal link to metric movements. operationId: getTimelineEvents parameters: - name: projectId in: path required: true schema: type: string format: uuid - name: windowDays in: query schema: type: integer enum: - 30 - 90 default: 30 description: >- Fixed rolling window in days. Supported values are 30 and 90. Defaults to 30. responses: '200': description: Project timeline events content: application/json: schema: type: object properties: data: type: object properties: window: type: object properties: days: type: integer enum: - 30 - 90 from: type: string format: date to: type: string format: date required: - days - from - to events: type: array maxItems: 500 items: $ref: '#/components/schemas/TimelineEvent' coverage: type: object description: >- Whether the response reached the event cap. A truncated response omits the oldest events in the window. properties: limit: type: integer example: 500 truncated: type: boolean example: false required: - limit - truncated required: - window - coverage - events meta: $ref: '#/components/schemas/Meta' required: - data - meta '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: TimelineEvent: type: object additionalProperties: false properties: id: type: string format: uuid source: type: string enum: - external - team - deterministic - detected - measured_action kind: type: string enum: - change_detected - change_claimed - measurement_opened - outcome_measured - prompts_added - prompts_deleted - prompts_restored - topic_deleted - platform_model_change - platform_outage - data_collection_gap - search_algorithm_update - citation_share_change - devtune_methodology_change description: >- Producer-specific event kind. Measured actions use change_detected, change_claimed, measurement_opened or outcome_measured. Detected citation-share facts use citation_share_change; external facts use a platform, data-collection, or DevTune change kind; prompt-set producers use a prompt or topic change kind. occurredAt: type: string format: date-time endedAt: type: - string - 'null' format: date-time platformKeys: anyOf: - type: array items: type: string - type: 'null' titleKey: type: - string - 'null' evidence: type: object additionalProperties: true properties: measuredAction: type: object additionalProperties: false properties: actionId: type: string format: uuid actionTitle: type: string interventionId: type: - string - 'null' format: uuid changeEventId: type: - string - 'null' format: uuid url: type: - string - 'null' result: type: string enum: - win - loss - still_measuring - unmeasured measurementOpenedAt: type: - string - 'null' format: date-time windowClosedAt: type: - string - 'null' format: date-time required: - interventionId - url description: >- Action identity is present when attributed. Changes and results carry changeEventId; openings and results carry measurementOpenedAt. Only results carry result and windowClosedAt. A result event requires the canonical Outcomes measured_at timestamp. detectedEvidence: anyOf: - type: object additionalProperties: false properties: platform: type: string domain: type: string direction: type: string enum: - up - down currentShare: type: number minimum: 0 maximum: 1 baselineShare: type: number minimum: 0 maximum: 1 absoluteChange: type: number relativeChange: type: - number - 'null' observationStart: type: string format: date observationEnd: type: string format: date projectCount: type: integer minimum: 0 projectFraction: type: number minimum: 0 maximum: 1 required: - platform - domain - direction - currentShare - baselineShare - absoluteChange - relativeChange - observationStart - observationEnd - projectCount - projectFraction - type: object additionalProperties: false properties: platform: type: string domain: type: string direction: type: string enum: - up - down currentShare: type: number minimum: 0 maximum: 1 baselineShare: type: number minimum: 0 maximum: 1 absoluteChange: type: number relativeChange: type: - number - 'null' observationStart: type: string format: date observationEnd: type: string format: date scope: type: string enum: - project domainRole: type: string enum: - own - competitor - other brandName: type: - string - 'null' incidentId: type: string format: uuid baselineStart: type: string format: date baselineEnd: type: string format: date cohortPromptCount: type: integer minimum: 0 activePromptCount: type: integer minimum: 0 status: type: string enum: - active - resolved resolvedAt: type: - string - 'null' format: date-time required: - platform - domain - direction - currentShare - baselineShare - absoluteChange - relativeChange - observationStart - observationEnd - scope - domainRole - brandName - incidentId - baselineStart - baselineEnd - cohortPromptCount - activePromptCount - status - resolvedAt - type: 'null' description: >- Producer evidence. Detected facts return global aggregate or project incident detectedEvidence. Project evidence includes domainRole (own, competitor or other), brandName (null for other), scope, incidentId, baseline dates, prompt counts, status and resolvedAt; only global evidence includes projectCount and projectFraction. External facts return title, description, and sourceUrl. Prompt additions include promptCount, topic, and requestedBy; deletions also include jobId and activeSlotsFreed; restores include jobId and topicRestored. Prompt names are not returned. required: - id - source - kind - occurredAt - endedAt - platformKeys - titleKey - evidence Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid Error: type: object properties: error: type: string message: type: string status: type: integer required: - error - message - status responses: UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' RateLimitExceededError: description: Rate limit exceeded headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' headers: X-RateLimit-Limit: description: Maximum requests per window schema: type: integer X-RateLimit-Remaining: description: Requests remaining in current window schema: type: integer X-RateLimit-Reset: description: Unix timestamp when the window resets schema: type: integer securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed. ````