> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List

> List the activity log entries for an incident, oldest first.

If the incident has streams, this returns their entries too, and incident_id on each entry
tells you which stream it came from.

Platform noise is left out: channel joins and leaves, chat messages and call transcript
fragments are recorded internally but never returned here.




## OpenAPI

````yaml /openapi/tags/incident-activity-log-entries-v2.json get /v2/incident_activity_log_entries
openapi: 3.0.3
info:
  description: "This is the API reference for incident.io.\n\nIt documents available API endpoints, provides examples of how to use it, and\ninstructions around things like authentication and error handling.\n\nThe API is hosted at:\n\n- https://api.incident.io/\n\nAnd you will need to create an API key via your [incident.io\ndashboard](https://app.incident.io/settings/api-keys) to make requests.\n\n# Making requests\n\nHere are the key concepts required to make requests to the incident.io API.\n\n## Authentication\n\nFor all requests made to the incident.io API, you'll need an API key.\n\nTo create an API key, head to the incident dashboard and visit [API\nkeys](https://app.incident.io/settings/api-keys). When you create the key, you'll be able to choose what actions it\ncan take for your account: choose carefully, as those roles can only be set\nwhen you first create the key. We'll only show you the token once, so make sure\nyou store it somewhere safe.\n\nAPI keys are global to your incident.io account, and can be managed by anyone\nwho has the right permissions. We display the user that created the API key,\nand the API key will remain valid if that user becomes deactivated.\n\nOnce you have the key, you should make requests to the API that set the\n`Authorization` request header using a \"Bearer\" authentication scheme:\n\n```\nAuthorization: Bearer <YOUR_API_KEY>\n```\n\n## Rate Limits\n\nThe incident.io API enforces rate limits to ensure consistent performance for all users.\n\nThe default rate limit is 1200 requests/minute per API key. This limit applies to most endpoints across the API.\n\nLimits are token buckets that refill continuously rather than resetting on a fixed window boundary. The default\nbucket holds 1200 requests and refills at 20 per second, so you can burst up to the full bucket and then sustain\n20 requests/second indefinitely. There is no boundary at which your quota resets to full in one step.\n\nSome endpoints have lower rate limits, particularly those that interact with external third-party systems that impose\ntheir own limitations. These specific limits vary by endpoint.\n\n### Rate limit headers\n\nResponses to requests authenticated with an API key carry your current allowance, so you can pace yourself rather\nthan waiting to be throttled:\n\n```\nX-RateLimit-Limit: 60, 1200;window=60, 60;window=60\nX-RateLimit-Remaining: 59\nX-RateLimit-Used: 1\nX-RateLimit-Reset: 1785173199\n```\n\n| Header | Meaning |\n| --- | --- |\n| `X-RateLimit-Limit` | The quota that binds this request, followed by every limit that applied and the window it applies over |\n| `X-RateLimit-Remaining` | Requests you can make right now against the binding limit |\n| `X-RateLimit-Used` | Requests you have spent against it |\n| `X-RateLimit-Reset` | Unix timestamp (seconds) at which that limit will be back to full |\n\nMore than one limit can apply to a request: your API key's overall limit, and for some endpoints a lower limit of\ntheir own. `X-RateLimit-Limit` lists all of them, each with its window, so `1200;window=60` means 1200 requests per\nminute. Because our limits refill continuously rather than resetting on a boundary, that window is what tells you\nthe rate you can sustain: 1200 per 60 seconds is 20 requests/second indefinitely.\n\n`Remaining`, `Used` and `Reset` describe whichever limit has the least allowance left, since that is the one you\nwill hit first.\n\n`X-RateLimit-Remaining` may lag by a small number of requests under high concurrency, and can move by more than the\nrequests you made, because limits scoped to your whole organisation are shared with your other API keys.\n\nHeaders are omitted rather than guessed if we cannot determine your allowance for a request.\n\n### Exceeding a rate limit\n\nWhen you exceed a rate limit the API responds with `429 Too Many Requests` and a `Retry-After` header giving the\nnumber of seconds to wait:\n\n```\nX-RateLimit-Limit: 1200, 1200;window=60\nX-RateLimit-Remaining: 0\nX-RateLimit-Used: 1200\nX-RateLimit-Reset: 1785173199\nRetry-After: 1\n```\n\nPrefer `Retry-After` over `X-RateLimit-Reset` when deciding how long to back off. `Retry-After` is when a single\nrequest will succeed; `X-RateLimit-Reset` is the later point at which your whole allowance has returned. It is a\nduration rather than a timestamp, so it does not depend on your clock agreeing with ours.\n\nThe 429 also carries a JSON body with the same information:\n\n```json\n{\n    \"type\": \"too_many_requests\",\n    \"status\": 429,\n    \"request_id\": \"b839a403-7704-41c1-bf6a-39a2d68caefa\",\n    \"rate_limit\": {\n        \"name\": \"api_key_name\",\n        \"limit\": 1200,\n        \"remaining\": 0,\n        \"retry_after\": \"2025-04-17T11:17:18Z\"\n    },\n    \"errors\": [\n        {\n            \"code\": \"too_many_requests\",\n            \"message\": \"Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.\"\n        }\n    ]\n}\n```\n\nThe response includes:\n* The name of the API key (`name`)\n* The bucket limit (`limit`)\n* The number of requests remaining (`remaining`)\n* When you can retry requests (`retry_after`), as an RFC3339 timestamp\n\n## Errors\n\nWe use standard HTTP response codes to indicate the status or failure of API\nrequests.\n\nThe API response body will be JSON, and contain more detailed information on the\nnature of the error.\n\nAn example error when a request is made without an API key:\n\n```json\n{\n  \"type\": \"authentication_error\",\n  \"status\": 401,\n  \"request_id\": \"8e3cc412-b49d-4957-9073-2c19d2c61804\",\n  \"errors\": [\n    {\n      \"code\": \"missing_authorization_material\",\n      \"message\": \"No authorization material provided in request\"\n    }\n  ]\n}\n```\n\nNote that the error:\n\n- Contains the HTTP status (`401`)\n- References the type of error (`authentication_error`)\n- Includes a `request_id` that can be provided to incident.io support to help\n\tdebug questions with your API request\n- Provides a list of individual errors, which go into detail about why the error\n\toccurred\n\nThe most common error will be a 422 Validation Error, which is returned when the\nrequest was rejected due to failing validations.\n\nThese errors look like this:\n\n```json\n{\n  \"type\": \"validation_error\",\n  \"status\": 422,\n  \"request_id\": \"631766c4-4afd-4803-997c-cd700928fa4b\",\n  \"errors\": [\n    {\n      \"code\": \"is_required\",\n      \"message\": \"A severity is required to open an incident\",\n      \"source\": {\n        \"field\": \"severity_id\"\n      }\n    }\n  ]\n}\n```\n\nThis error is caused by not providing a severity identifier, which should be at\nthe `severity_id` field of the request payload. Errors like these can be mapped to\nforms, should you be integrating with the API from a user-interface.\n\n## Compatibility\n\nWe won't make breaking changes to existing API services or endpoints, but will\nexpect integrators to upgrade themselves to the latest API endpoints within 3\nmonths of us deprecating the old service.\n\nWe will make changes that are considered backwards compatible, which include:\n\n- Adding new API endpoints and services\n- Adding new properties to responses from existing API endpoints\n- Reordering properties returned from existing API endpoints\n- Adding optional request parameters to existing API endpoints\n- Altering the format or length of IDs\n- Adding new values to enums\n\nIt is important that clients are robust to these changes, to ensure reliable\nintegrations.\n\nAs an example, if you are generating a client using an openapi-generator, ensure\nthe generated client is configured to support unknown enum values, often\nconfigured via the `enumUnknownDefaultCase` parameter.\n\nWhen breaking changes are unavoidable, we'll create a new service version on a\nseparate path, and run them in parallel.\n\nFor example:\n\n- https://api.incident.io/v1/incidents\n- https://api.incident.io/v2/incidents\n\nFor any questions, email support@incident.io.\n"
  title: incident.io
  version: 1.0.0
servers:
  - url: https://api.incident.io
security:
  - BearerAuth: []
tags:
  - description: >
      Read everything that happened on an incident.


      The activity log is the full record: every status change, role handover,
      escalation, field

      edit and update, in the order they happened. Some of it gets promoted onto
      the incident's

      timeline, which also carries items written by hand that never appear here.


      Use this to pull an incident's history into your own systems - a
      retrospective, a report, an

      audit of how a response ran.
    name: Incident Activity Log Entries V2
paths:
  /v2/incident_activity_log_entries:
    get:
      tags:
        - Incident Activity Log Entries V2
      summary: List
      description: >
        List the activity log entries for an incident, oldest first.


        If the incident has streams, this returns their entries too, and
        incident_id on each entry

        tells you which stream it came from.


        Platform noise is left out: channel joins and leaves, chat messages and
        call transcript

        fragments are recorded internally but never returned here.
      operationId: Incident Activity Log Entries V2_List
      parameters:
        - allowEmptyValue: true
          description: Incident whose activity you want to list
          example: 01G0J1EXE7AXZ2C93K61WBPYEH
          in: query
          name: incident_id
          required: true
          schema:
            example: 01FCNDV6P870EA6S7TK1DSYD5H
            type: string
        - allowEmptyValue: true
          description: Return only the entries with these IDs
          example:
            - 01FCNDV6P870EA6S7TK1DSYDG0
            - 01FCNDV6P870EA6S7TK1DSYDG1
          in: query
          name: id
          schema:
            description: Return only the entries with these IDs
            example:
              - 01FCNDV6P870EA6S7TK1DSYDG0
              - 01FCNDV6P870EA6S7TK1DSYDG1
            items:
              example: abc123
              type: string
            maxItems: 100
            type: array
        - allowEmptyValue: true
          description: Integer number of records to return
          example: 25
          in: query
          name: page_size
          schema:
            default: 25
            description: Integer number of records to return
            example: 25
            format: int64
            maximum: 250
            minimum: 1
            type: integer
        - allowEmptyValue: true
          description: An entry's ID. This endpoint returns the entries that follow it.
          examples:
            default:
              summary: default
              value: 01FCNDV6P870EA6S7TK1DSYDG0
          in: query
          name: after
          schema:
            description: An entry's ID. This endpoint returns the entries that follow it.
            example: 01FCNDV6P870EA6S7TK1DSYDG0
            type: string
      responses:
        '200':
          content:
            application/json:
              example:
                incident_activity_log_entries:
                  - content:
                      action_created:
                        action_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        actor:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      action_updated:
                        action_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        new_assignee:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        new_status: completed
                        previous_assignee:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        previous_status: outstanding
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      alert_attached_to_incident:
                        actor:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                        alert_id: 01FCNDV6P870EA6S7TK1DSYDG0
                      custom_field_value_update:
                        custom_field:
                          description: Which team is impacted by this issue
                          field_type: single_select
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Affected Team
                          options:
                            - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                              id: 01FCNDV6P870EA6S7TK1DSYDG0
                              sort_key: 10
                              value: Product
                        new_values:
                          - value_catalog_entry:
                              aliases:
                                - lawrence@incident.io
                                - lawrence
                              external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                              id: 01FCNDV6P870EA6S7TK1DSYDG0
                              name: Primary On-call
                            value_link: https://google.com/
                            value_numeric: '123.456'
                            value_option:
                              custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                              id: 01FCNDV6P870EA6S7TK1DSYDG0
                              sort_key: 10
                              value: Product
                            value_text: This is my text field, I hope you like it
                        new_values_count: 4
                        previous_values:
                          - value_catalog_entry:
                              aliases:
                                - lawrence@incident.io
                                - lawrence
                              external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                              id: 01FCNDV6P870EA6S7TK1DSYDG0
                              name: Primary On-call
                            value_link: https://google.com/
                            value_numeric: '123.456'
                            value_option:
                              custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                              id: 01FCNDV6P870EA6S7TK1DSYDG0
                              sort_key: 10
                              value: Product
                            value_text: This is my text field, I hope you like it
                        previous_values_count: 3
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      escalation_acknowledged:
                        acknowledger:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
                      escalation_created:
                        creator:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                        escalated_to_users:
                          - email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                        escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        escalation_path_id: 01FCNDV6P870EA6S7TK1DSYDG1
                      follow_up_created:
                        actor:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                        follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
                      follow_up_updated:
                        follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        new_assignee:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        new_status: completed
                        new_title: Add a payments-api rollback runbook
                        previous_assignee:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        previous_status: outstanding
                        previous_title: Add a runbook
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      incident_merged:
                        incident_update_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        merger:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                        source_incident:
                          external_id: 123
                          id: 01FDAG4SAP5TYPT98WGR2N7W91
                          name: Our database is sad
                          reference: INC-123
                          status_category: triage
                          summary: >-
                            Our database is really really sad, and we don't know
                            why yet.
                          visibility: public
                      incident_rename:
                        new_name: EU checkout failing after 14:02 deploy
                        previous_name: Checkout errors
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      incident_timestamp_set:
                        incident_timestamp:
                          id: 01FCNDV6P870EA6S7TK1DSYD5H
                          name: Impact started
                          rank: 1
                        new_value: '2026-09-01T13:42:00Z'
                        previous_value: '2026-09-01T14:00:00Z'
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      incident_type_changed:
                        new_incident_type:
                          create_in_triage: always
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: Customer facing production outages
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          is_default: false
                          name: Production Outage
                          private_incidents_only: false
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        previous_incident_type:
                          create_in_triage: always
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: Customer facing production outages
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          is_default: false
                          name: Production Outage
                          private_incidents_only: false
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      incident_update:
                        id: 01FCNDV6P870EA6S7TK1DSYDG0
                        message: >-
                          Rolled back **payments-api** to v411, error rate
                          recovering.
                        new_severity:
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: Issues with **low impact**.
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Minor
                          rank: 1
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        new_status:
                          category: triage
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: >-
                            Impact has been **fully mitigated**, and we're ready
                            to learn from this incident.
                          id: 01FCNDV6P870EA6S7TK1DSYD5H
                          name: Closed
                          rank: 4
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        next_update_in_minutes: 30
                        previous_severity:
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: Issues with **low impact**.
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Minor
                          rank: 1
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        previous_status:
                          category: triage
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: >-
                            Impact has been **fully mitigated**, and we're ready
                            to learn from this incident.
                          id: 01FCNDV6P870EA6S7TK1DSYD5H
                          name: Closed
                          rank: 4
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      incident_visibility_changed:
                        new_visibility: private
                        previous_visibility: public
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      role_update:
                        new_assignee:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        previous_assignee:
                          email: lisa@incident.io
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          name: Lisa Karlin Curtis
                          role: owner
                          slack_user_id: U02AYNF2XJM
                        role:
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: The person currently coordinating the incident
                          id: 01FCNDV6P870EA6S7TK1DSYDG0
                          instructions: >-
                            Take point on the incident; Make sure people are
                            clear on responsibilities
                          name: Incident Lead
                          role_type: lead
                          shortform: lead
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      status_change:
                        new_status:
                          category: triage
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: >-
                            Impact has been **fully mitigated**, and we're ready
                            to learn from this incident.
                          id: 01FCNDV6P870EA6S7TK1DSYD5H
                          name: Closed
                          rank: 4
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        previous_status:
                          category: triage
                          created_at: '2021-08-17T13:28:57.801578Z'
                          description: >-
                            Impact has been **fully mitigated**, and we're ready
                            to learn from this incident.
                          id: 01FCNDV6P870EA6S7TK1DSYD5H
                          name: Closed
                          rank: 4
                          updated_at: '2021-08-17T13:28:57.801578Z'
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      summary_update:
                        new_summary: >-
                          Checkout is failing for all EU customers since the
                          14:02 deploy.
                        previous_summary: Checkout is failing for some customers.
                        updater:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                      workflow_ran:
                        creator:
                          alert:
                            id: 01GW2G3V0S59R238FAHPDS1R66
                            title: '*errors.withMessage: PG::Error failed to connect'
                          api_key:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My test API key
                          user:
                            email: lisa@incident.io
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: Lisa Karlin Curtis
                            role: owner
                            slack_user_id: U02AYNF2XJM
                          workflow:
                            id: 01FCNDV6P870EA6S7TK1DSYDG0
                            name: My little workflow
                        event_description: Stopped the synthetic load test in staging.
                        event_title: Load test halted
                    created_at: '2026-09-01T15:30:01Z'
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    incident_id: 01G0J1EXE7AXZ2C93K61WBPYEH
                    occurred_at: '2026-09-01T15:30:00Z'
                    title: Status changed from Investigating to Monitoring
                    type: incident_update
                pagination_meta:
                  after: 01FCNDV6P870EA6S7TK1DSYDG0
                  page_size: 25
              schema:
                $ref: '#/components/schemas/IncidentActivityLogEntriesListResultV2'
          description: OK response.
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            invalid_request_error: There was a problem with the request, like a
            missing header or querying a resource that doesn't exist.
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'authentication_error: Authentication failed.'
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            resource_forbidden: Access to this resource is forbidden for the
            authenticated user.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'not_found: The referenced resource could not be found.'
        '405':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            method_not_allowed: The endpoint does not support this operation for
            the specified resource.
        '406':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            not_acceptable: Requested a media type this endpoint does not
            support.
        '408':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: |-
            request_timeout: The request took too long to process.

            client_timeout: The request was cancelled by the client.
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            conflict: Request conflicted with current state of the resource,
            likely a concurrent update.
        '412':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'precondition_failed: A required condition hasn''t been met.'
        '413':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'payload_too_large: The request payload is too large.'
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            validation_error: A required field was not provided, or the provided
            data was invalid.
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: >-
            too_many_requests: Too many requests hit the API too quickly. We
            recommend an exponential backoff of your requests.


            rate_limit_reached: The rate limit associated with this resource or
            API key has been exceeded. Try again later.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: 'api_error: Something went wrong and has been reported internally.'
components:
  schemas:
    IncidentActivityLogEntriesListResultV2:
      example:
        incident_activity_log_entries:
          - content:
              action_created:
                action_id: 01FCNDV6P870EA6S7TK1DSYDG0
                actor:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              action_updated:
                action_id: 01FCNDV6P870EA6S7TK1DSYDG0
                new_assignee:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                new_status: completed
                previous_assignee:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                previous_status: outstanding
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              alert_attached_to_incident:
                actor:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
                alert_id: 01FCNDV6P870EA6S7TK1DSYDG0
              custom_field_value_update:
                custom_field:
                  description: Which team is impacted by this issue
                  field_type: single_select
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Affected Team
                  options:
                    - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      sort_key: 10
                      value: Product
                new_values:
                  - value_catalog_entry:
                      aliases:
                        - lawrence@incident.io
                        - lawrence
                      external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Primary On-call
                    value_link: https://google.com/
                    value_numeric: '123.456'
                    value_option:
                      custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      sort_key: 10
                      value: Product
                    value_text: This is my text field, I hope you like it
                new_values_count: 4
                previous_values:
                  - value_catalog_entry:
                      aliases:
                        - lawrence@incident.io
                        - lawrence
                      external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Primary On-call
                    value_link: https://google.com/
                    value_numeric: '123.456'
                    value_option:
                      custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      sort_key: 10
                      value: Product
                    value_text: This is my text field, I hope you like it
                previous_values_count: 3
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              escalation_acknowledged:
                acknowledger:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
              escalation_created:
                creator:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
                escalated_to_users:
                  - email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
                escalation_path_id: 01FCNDV6P870EA6S7TK1DSYDG1
              follow_up_created:
                actor:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
                follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
              follow_up_updated:
                follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
                new_assignee:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                new_status: completed
                new_title: Add a payments-api rollback runbook
                previous_assignee:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                previous_status: outstanding
                previous_title: Add a runbook
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              incident_merged:
                incident_update_id: 01FCNDV6P870EA6S7TK1DSYDG0
                merger:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
                source_incident:
                  external_id: 123
                  id: 01FDAG4SAP5TYPT98WGR2N7W91
                  name: Our database is sad
                  reference: INC-123
                  status_category: triage
                  summary: >-
                    Our database is really really sad, and we don't know why
                    yet.
                  visibility: public
              incident_rename:
                new_name: EU checkout failing after 14:02 deploy
                previous_name: Checkout errors
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              incident_timestamp_set:
                incident_timestamp:
                  id: 01FCNDV6P870EA6S7TK1DSYD5H
                  name: Impact started
                  rank: 1
                new_value: '2026-09-01T13:42:00Z'
                previous_value: '2026-09-01T14:00:00Z'
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              incident_type_changed:
                new_incident_type:
                  create_in_triage: always
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: Customer facing production outages
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  is_default: false
                  name: Production Outage
                  private_incidents_only: false
                  updated_at: '2021-08-17T13:28:57.801578Z'
                previous_incident_type:
                  create_in_triage: always
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: Customer facing production outages
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  is_default: false
                  name: Production Outage
                  private_incidents_only: false
                  updated_at: '2021-08-17T13:28:57.801578Z'
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              incident_update:
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                message: Rolled back **payments-api** to v411, error rate recovering.
                new_severity:
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: Issues with **low impact**.
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Minor
                  rank: 1
                  updated_at: '2021-08-17T13:28:57.801578Z'
                new_status:
                  category: triage
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: >-
                    Impact has been **fully mitigated**, and we're ready to
                    learn from this incident.
                  id: 01FCNDV6P870EA6S7TK1DSYD5H
                  name: Closed
                  rank: 4
                  updated_at: '2021-08-17T13:28:57.801578Z'
                next_update_in_minutes: 30
                previous_severity:
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: Issues with **low impact**.
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Minor
                  rank: 1
                  updated_at: '2021-08-17T13:28:57.801578Z'
                previous_status:
                  category: triage
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: >-
                    Impact has been **fully mitigated**, and we're ready to
                    learn from this incident.
                  id: 01FCNDV6P870EA6S7TK1DSYD5H
                  name: Closed
                  rank: 4
                  updated_at: '2021-08-17T13:28:57.801578Z'
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              incident_visibility_changed:
                new_visibility: private
                previous_visibility: public
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              role_update:
                new_assignee:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                previous_assignee:
                  email: lisa@incident.io
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  name: Lisa Karlin Curtis
                  role: owner
                  slack_user_id: U02AYNF2XJM
                role:
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: The person currently coordinating the incident
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  instructions: >-
                    Take point on the incident; Make sure people are clear on
                    responsibilities
                  name: Incident Lead
                  role_type: lead
                  shortform: lead
                  updated_at: '2021-08-17T13:28:57.801578Z'
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              status_change:
                new_status:
                  category: triage
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: >-
                    Impact has been **fully mitigated**, and we're ready to
                    learn from this incident.
                  id: 01FCNDV6P870EA6S7TK1DSYD5H
                  name: Closed
                  rank: 4
                  updated_at: '2021-08-17T13:28:57.801578Z'
                previous_status:
                  category: triage
                  created_at: '2021-08-17T13:28:57.801578Z'
                  description: >-
                    Impact has been **fully mitigated**, and we're ready to
                    learn from this incident.
                  id: 01FCNDV6P870EA6S7TK1DSYD5H
                  name: Closed
                  rank: 4
                  updated_at: '2021-08-17T13:28:57.801578Z'
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              summary_update:
                new_summary: >-
                  Checkout is failing for all EU customers since the 14:02
                  deploy.
                previous_summary: Checkout is failing for some customers.
                updater:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
              workflow_ran:
                creator:
                  alert:
                    id: 01GW2G3V0S59R238FAHPDS1R66
                    title: '*errors.withMessage: PG::Error failed to connect'
                  api_key:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My test API key
                  user:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  workflow:
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: My little workflow
                event_description: Stopped the synthetic load test in staging.
                event_title: Load test halted
            created_at: '2026-09-01T15:30:01Z'
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            incident_id: 01G0J1EXE7AXZ2C93K61WBPYEH
            occurred_at: '2026-09-01T15:30:00Z'
            title: Status changed from Investigating to Monitoring
            type: incident_update
        pagination_meta:
          after: 01FCNDV6P870EA6S7TK1DSYDG0
          page_size: 25
      properties:
        incident_activity_log_entries:
          example:
            - content:
                action_created:
                  action_id: 01FCNDV6P870EA6S7TK1DSYDG0
                  actor:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                action_updated:
                  action_id: 01FCNDV6P870EA6S7TK1DSYDG0
                  new_assignee:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  new_status: completed
                  previous_assignee:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  previous_status: outstanding
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                alert_attached_to_incident:
                  actor:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                  alert_id: 01FCNDV6P870EA6S7TK1DSYDG0
                custom_field_value_update:
                  custom_field:
                    description: Which team is impacted by this issue
                    field_type: single_select
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Affected Team
                    options:
                      - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        id: 01FCNDV6P870EA6S7TK1DSYDG0
                        sort_key: 10
                        value: Product
                  new_values:
                    - value_catalog_entry:
                        aliases:
                          - lawrence@incident.io
                          - lawrence
                        external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                        id: 01FCNDV6P870EA6S7TK1DSYDG0
                        name: Primary On-call
                      value_link: https://google.com/
                      value_numeric: '123.456'
                      value_option:
                        custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        id: 01FCNDV6P870EA6S7TK1DSYDG0
                        sort_key: 10
                        value: Product
                      value_text: This is my text field, I hope you like it
                  new_values_count: 4
                  previous_values:
                    - value_catalog_entry:
                        aliases:
                          - lawrence@incident.io
                          - lawrence
                        external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                        id: 01FCNDV6P870EA6S7TK1DSYDG0
                        name: Primary On-call
                      value_link: https://google.com/
                      value_numeric: '123.456'
                      value_option:
                        custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                        id: 01FCNDV6P870EA6S7TK1DSYDG0
                        sort_key: 10
                        value: Product
                      value_text: This is my text field, I hope you like it
                  previous_values_count: 3
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                escalation_acknowledged:
                  acknowledger:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
                escalation_created:
                  creator:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                  escalated_to_users:
                    - email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                  escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
                  escalation_path_id: 01FCNDV6P870EA6S7TK1DSYDG1
                follow_up_created:
                  actor:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                  follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
                follow_up_updated:
                  follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
                  new_assignee:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  new_status: completed
                  new_title: Add a payments-api rollback runbook
                  previous_assignee:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  previous_status: outstanding
                  previous_title: Add a runbook
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                incident_merged:
                  incident_update_id: 01FCNDV6P870EA6S7TK1DSYDG0
                  merger:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                  source_incident:
                    external_id: 123
                    id: 01FDAG4SAP5TYPT98WGR2N7W91
                    name: Our database is sad
                    reference: INC-123
                    status_category: triage
                    summary: >-
                      Our database is really really sad, and we don't know why
                      yet.
                    visibility: public
                incident_rename:
                  new_name: EU checkout failing after 14:02 deploy
                  previous_name: Checkout errors
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                incident_timestamp_set:
                  incident_timestamp:
                    id: 01FCNDV6P870EA6S7TK1DSYD5H
                    name: Impact started
                    rank: 1
                  new_value: '2026-09-01T13:42:00Z'
                  previous_value: '2026-09-01T14:00:00Z'
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                incident_type_changed:
                  new_incident_type:
                    create_in_triage: always
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: Customer facing production outages
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    is_default: false
                    name: Production Outage
                    private_incidents_only: false
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  previous_incident_type:
                    create_in_triage: always
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: Customer facing production outages
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    is_default: false
                    name: Production Outage
                    private_incidents_only: false
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                incident_update:
                  id: 01FCNDV6P870EA6S7TK1DSYDG0
                  message: Rolled back **payments-api** to v411, error rate recovering.
                  new_severity:
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: Issues with **low impact**.
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Minor
                    rank: 1
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  new_status:
                    category: triage
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: >-
                      Impact has been **fully mitigated**, and we're ready to
                      learn from this incident.
                    id: 01FCNDV6P870EA6S7TK1DSYD5H
                    name: Closed
                    rank: 4
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  next_update_in_minutes: 30
                  previous_severity:
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: Issues with **low impact**.
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Minor
                    rank: 1
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  previous_status:
                    category: triage
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: >-
                      Impact has been **fully mitigated**, and we're ready to
                      learn from this incident.
                    id: 01FCNDV6P870EA6S7TK1DSYD5H
                    name: Closed
                    rank: 4
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                incident_visibility_changed:
                  new_visibility: private
                  previous_visibility: public
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                role_update:
                  new_assignee:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  previous_assignee:
                    email: lisa@incident.io
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    name: Lisa Karlin Curtis
                    role: owner
                    slack_user_id: U02AYNF2XJM
                  role:
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: The person currently coordinating the incident
                    id: 01FCNDV6P870EA6S7TK1DSYDG0
                    instructions: >-
                      Take point on the incident; Make sure people are clear on
                      responsibilities
                    name: Incident Lead
                    role_type: lead
                    shortform: lead
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                status_change:
                  new_status:
                    category: triage
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: >-
                      Impact has been **fully mitigated**, and we're ready to
                      learn from this incident.
                    id: 01FCNDV6P870EA6S7TK1DSYD5H
                    name: Closed
                    rank: 4
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  previous_status:
                    category: triage
                    created_at: '2021-08-17T13:28:57.801578Z'
                    description: >-
                      Impact has been **fully mitigated**, and we're ready to
                      learn from this incident.
                    id: 01FCNDV6P870EA6S7TK1DSYD5H
                    name: Closed
                    rank: 4
                    updated_at: '2021-08-17T13:28:57.801578Z'
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                summary_update:
                  new_summary: >-
                    Checkout is failing for all EU customers since the 14:02
                    deploy.
                  previous_summary: Checkout is failing for some customers.
                  updater:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                workflow_ran:
                  creator:
                    alert:
                      id: 01GW2G3V0S59R238FAHPDS1R66
                      title: '*errors.withMessage: PG::Error failed to connect'
                    api_key:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My test API key
                    user:
                      email: lisa@incident.io
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: Lisa Karlin Curtis
                      role: owner
                      slack_user_id: U02AYNF2XJM
                    workflow:
                      id: 01FCNDV6P870EA6S7TK1DSYDG0
                      name: My little workflow
                  event_description: Stopped the synthetic load test in staging.
                  event_title: Load test halted
              created_at: '2026-09-01T15:30:01Z'
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              incident_id: 01G0J1EXE7AXZ2C93K61WBPYEH
              occurred_at: '2026-09-01T15:30:00Z'
              title: Status changed from Investigating to Monitoring
              type: incident_update
          items:
            $ref: '#/components/schemas/IncidentActivityLogEntryV2'
          type: array
        pagination_meta:
          $ref: '#/components/schemas/PaginationMetaResultV2'
      required:
        - incident_activity_log_entries
      type: object
    ErrorResponse:
      example:
        debug:
          message: 'Something broke: and something else: and something else'
          stacktrace:
            - thing.go:123
        errors:
          - code: trial_expired
            message: Default incident call link must be a valid URL
            metadata:
              abc123: abc123
            source:
              field: default_call_url
              pointer: /settings/default_call_url
        rate_limit:
          limit: 100
          name: client_ip
          remaining: 98
          retry_after: '2020-01-01T00:00:00Z'
        request_id: 2T1p0e3j
        status: 408
        type: invalid_request_error
      properties:
        debug:
          $ref: '#/components/schemas/ErrorDebug'
        errors:
          description: List of errors that caused this request to fail
          example:
            - code: trial_expired
              message: Default incident call link must be a valid URL
              metadata:
                abc123: abc123
              source:
                field: default_call_url
                pointer: /settings/default_call_url
          items:
            $ref: '#/components/schemas/ErrorSingle'
          type: array
        rate_limit:
          $ref: '#/components/schemas/ErrorRateLimit'
        request_id:
          description: Unique identifier of the request
          example: 2T1p0e3j
          type: string
        status:
          description: HTTP status of the response
          example: 408
          format: int64
          type: integer
        type:
          description: Machine-readable identifier for the general category of error
          enum:
            - invalid_request_error
            - authentication_error
            - resource_forbidden
            - not_found
            - not_acceptable
            - method_not_allowed
            - request_timeout
            - conflict
            - precondition_failed
            - payload_too_large
            - validation_error
            - too_many_requests
            - api_error
            - rate_limit_reached
            - client_timeout
          example: invalid_request_error
          type: string
      required:
        - type
        - status
        - request_id
        - errors
      type: object
    IncidentActivityLogEntryV2:
      description: >-
        One thing that happened on an incident.


        The activity log records everything. The timeline is the narrative, made
        of the entries

        someone promoted onto it and the items they wrote by hand.
      properties:
        content:
          $ref: '#/components/schemas/IncidentActivityLogContentV2'
        created_at:
          description: When we recorded the activity
          example: '2026-09-01T15:30:01Z'
          format: date-time
          type: string
        id:
          description: Unique identifier of the activity log entry
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        incident_id:
          description: >-
            ID of the incident this happened on. When the incident has streams,
            listing the parent also returns entries from its streams, and this
            is the stream's ID for those.
          example: 01G0J1EXE7AXZ2C93K61WBPYEH
          type: string
        occurred_at:
          description: When the activity happened. This is what the log is ordered by.
          example: '2026-09-01T15:30:00Z'
          format: date-time
          type: string
        title:
          description: Human-readable summary of what happened
          example: Status changed from Investigating to Monitoring
          type: string
        type:
          description: >-
            What kind of activity this is. Switch on this rather than title,
            which is display copy we reword.
          enum:
            - slack_pin
            - microsoft_teams_pinned_channel_message
            - summary_update
            - role_update
            - handover
            - slack_infer_sentry
            - slack_image
            - microsoft_teams_image
            - slack_message
            - incident_channel_join
            - incident_channel_leave
            - incident_escalate
            - action_created
            - action_updated
            - follow_up_created
            - follow_up_updated
            - actions_shared_in_channel
            - follow_ups_shared_in_channel
            - status_change
            - atlassian_statuspage_update
            - incident_update
            - custom_field_value_update
            - incident_membership_revoked
            - incident_visibility_changed
            - incident_rename
            - incident_attachment_added
            - incident_attachment_removed
            - alert_attached_to_incident
            - alert_group_attached_to_incident
            - alert_group_detached_from_incident
            - pagerduty_incident_triggered
            - pagerduty_incident_acknowledged
            - pagerduty_incident_resolved
            - incident_timestamp_set
            - incident_timestamp_occurred
            - incident_merged
            - incident_type_changed
            - status_page_incident_linked
            - status_page_incident_updated
            - user_intent_declared
            - call_url_changed
            - postmortem_changed
            - postmortem_document_v2_changed
            - incident_channel_created
            - scrub
            - escalation_created
            - escalation_acknowledged
            - incident_call_created
            - incident_call_started
            - incident_call_ended
            - incident_call_participants_updated
            - microsoft_teams_message
            - microsoft_teams_announcement_reply
            - incident_call_transcript_message
            - incident_call_transcript_summary_generated
            - incident_call_transcript_key_moment_generated
            - incident_call_transcript_current_topic_generated
            - incident_call_recall_bot_status_changed
            - scribe_added
            - scribe_removed
            - external_issue_comment_synced
            - investigation_hypothesis_update
            - workflow_ran
          example: incident_update
          type: string
      required:
        - id
        - incident_id
        - type
        - title
        - occurred_at
        - created_at
      type: object
    PaginationMetaResultV2:
      example:
        after: 01FCNDV6P870EA6S7TK1DSYDG0
        page_size: 25
      properties:
        after:
          description: If provided, pass this as the 'after' param to load the next page
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        page_size:
          default: 25
          description: What was the maximum number of results requested
          example: 25
          format: int64
          maximum: 250
          type: integer
      required:
        - page_size
      type: object
    ErrorDebug:
      example:
        message: 'Something broke: and something else: and something else'
        stacktrace:
          - thing.go:123
      properties:
        message:
          description: Original internal error message
          example: 'Something broke: and something else: and something else'
          type: string
        stacktrace:
          description: Stacktrace of the error, if applicable
          example:
            - thing.go:123
          items:
            example: thing.go:123
            type: string
          type: array
      required:
        - message
        - stacktrace
      type: object
    ErrorSingle:
      example:
        code: trial_expired
        message: Default incident call link must be a valid URL
        metadata:
          abc123: abc123
        source:
          field: default_call_url
          pointer: /settings/default_call_url
      properties:
        code:
          description: Machine-readable identifier for this specific error
          example: trial_expired
          type: string
        message:
          description: Human readable description of the error
          example: Default incident call link must be a valid URL
          type: string
        metadata:
          additionalProperties:
            example: abc123
            type: string
          description: Additional metadata about the error, keyed by a string identifier
          example:
            abc123: abc123
          type: object
        source:
          $ref: '#/components/schemas/ErrorSource'
      required:
        - code
        - message
      type: object
    ErrorRateLimit:
      example:
        limit: 100
        name: client_ip
        remaining: 98
        retry_after: '2020-01-01T00:00:00Z'
      properties:
        limit:
          description: >-
            The maximum number of requests that the consumer is permitted to
            make per minute
          example: 100
          format: int64
          type: integer
        name:
          description: Which rate limit was exceeded
          example: client_ip
          type: string
        remaining:
          description: The number of requests remaining in the current rate limit window
          example: 98
          format: int64
          type: integer
        retry_after:
          description: >-
            When the client can retry, as an RFC3339 timestamp in UTC. Prefer
            the Retry-After response header, which carries the same instant as a
            number of seconds
          example: '2020-01-01T00:00:00Z'
          type: string
      required:
        - name
        - limit
        - remaining
        - retry_after
      type: object
    IncidentActivityLogContentV2:
      description: >-
        Details of an activity log entry.


        At most one key is set, and it matches the entry's type. Types not
        listed here carry no

        content: the entry's type and title are all there is.
      example:
        action_created:
          action_id: 01FCNDV6P870EA6S7TK1DSYDG0
          actor:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        action_updated:
          action_id: 01FCNDV6P870EA6S7TK1DSYDG0
          new_assignee:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          new_status: completed
          previous_assignee:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          previous_status: outstanding
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        alert_attached_to_incident:
          actor:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
          alert_id: 01FCNDV6P870EA6S7TK1DSYDG0
        custom_field_value_update:
          custom_field:
            description: Which team is impacted by this issue
            field_type: single_select
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Affected Team
            options:
              - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                sort_key: 10
                value: Product
          new_values:
            - value_catalog_entry:
                aliases:
                  - lawrence@incident.io
                  - lawrence
                external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                name: Primary On-call
              value_link: https://google.com/
              value_numeric: '123.456'
              value_option:
                custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                sort_key: 10
                value: Product
              value_text: This is my text field, I hope you like it
          new_values_count: 4
          previous_values:
            - value_catalog_entry:
                aliases:
                  - lawrence@incident.io
                  - lawrence
                external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                name: Primary On-call
              value_link: https://google.com/
              value_numeric: '123.456'
              value_option:
                custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                sort_key: 10
                value: Product
              value_text: This is my text field, I hope you like it
          previous_values_count: 3
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        escalation_acknowledged:
          acknowledger:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
        escalation_created:
          creator:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
          escalated_to_users:
            - email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
          escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
          escalation_path_id: 01FCNDV6P870EA6S7TK1DSYDG1
        follow_up_created:
          actor:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
          follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
        follow_up_updated:
          follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
          new_assignee:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          new_status: completed
          new_title: Add a payments-api rollback runbook
          previous_assignee:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          previous_status: outstanding
          previous_title: Add a runbook
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        incident_merged:
          incident_update_id: 01FCNDV6P870EA6S7TK1DSYDG0
          merger:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
          source_incident:
            external_id: 123
            id: 01FDAG4SAP5TYPT98WGR2N7W91
            name: Our database is sad
            reference: INC-123
            status_category: triage
            summary: Our database is really really sad, and we don't know why yet.
            visibility: public
        incident_rename:
          new_name: EU checkout failing after 14:02 deploy
          previous_name: Checkout errors
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        incident_timestamp_set:
          incident_timestamp:
            id: 01FCNDV6P870EA6S7TK1DSYD5H
            name: Impact started
            rank: 1
          new_value: '2026-09-01T13:42:00Z'
          previous_value: '2026-09-01T14:00:00Z'
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        incident_type_changed:
          new_incident_type:
            create_in_triage: always
            created_at: '2021-08-17T13:28:57.801578Z'
            description: Customer facing production outages
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            is_default: false
            name: Production Outage
            private_incidents_only: false
            updated_at: '2021-08-17T13:28:57.801578Z'
          previous_incident_type:
            create_in_triage: always
            created_at: '2021-08-17T13:28:57.801578Z'
            description: Customer facing production outages
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            is_default: false
            name: Production Outage
            private_incidents_only: false
            updated_at: '2021-08-17T13:28:57.801578Z'
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        incident_update:
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          message: Rolled back **payments-api** to v411, error rate recovering.
          new_severity:
            created_at: '2021-08-17T13:28:57.801578Z'
            description: Issues with **low impact**.
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Minor
            rank: 1
            updated_at: '2021-08-17T13:28:57.801578Z'
          new_status:
            category: triage
            created_at: '2021-08-17T13:28:57.801578Z'
            description: >-
              Impact has been **fully mitigated**, and we're ready to learn from
              this incident.
            id: 01FCNDV6P870EA6S7TK1DSYD5H
            name: Closed
            rank: 4
            updated_at: '2021-08-17T13:28:57.801578Z'
          next_update_in_minutes: 30
          previous_severity:
            created_at: '2021-08-17T13:28:57.801578Z'
            description: Issues with **low impact**.
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Minor
            rank: 1
            updated_at: '2021-08-17T13:28:57.801578Z'
          previous_status:
            category: triage
            created_at: '2021-08-17T13:28:57.801578Z'
            description: >-
              Impact has been **fully mitigated**, and we're ready to learn from
              this incident.
            id: 01FCNDV6P870EA6S7TK1DSYD5H
            name: Closed
            rank: 4
            updated_at: '2021-08-17T13:28:57.801578Z'
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        incident_visibility_changed:
          new_visibility: private
          previous_visibility: public
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        role_update:
          new_assignee:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          previous_assignee:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          role:
            created_at: '2021-08-17T13:28:57.801578Z'
            description: The person currently coordinating the incident
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            instructions: >-
              Take point on the incident; Make sure people are clear on
              responsibilities
            name: Incident Lead
            role_type: lead
            shortform: lead
            updated_at: '2021-08-17T13:28:57.801578Z'
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        status_change:
          new_status:
            category: triage
            created_at: '2021-08-17T13:28:57.801578Z'
            description: >-
              Impact has been **fully mitigated**, and we're ready to learn from
              this incident.
            id: 01FCNDV6P870EA6S7TK1DSYD5H
            name: Closed
            rank: 4
            updated_at: '2021-08-17T13:28:57.801578Z'
          previous_status:
            category: triage
            created_at: '2021-08-17T13:28:57.801578Z'
            description: >-
              Impact has been **fully mitigated**, and we're ready to learn from
              this incident.
            id: 01FCNDV6P870EA6S7TK1DSYD5H
            name: Closed
            rank: 4
            updated_at: '2021-08-17T13:28:57.801578Z'
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        summary_update:
          new_summary: Checkout is failing for all EU customers since the 14:02 deploy.
          previous_summary: Checkout is failing for some customers.
          updater:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
        workflow_ran:
          creator:
            alert:
              id: 01GW2G3V0S59R238FAHPDS1R66
              title: '*errors.withMessage: PG::Error failed to connect'
            api_key:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My test API key
            user:
              email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
            workflow:
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: My little workflow
          event_description: Stopped the synthetic load test in staging.
          event_title: Load test halted
      properties:
        action_created:
          $ref: '#/components/schemas/ActivityActionRefV2'
        action_updated:
          $ref: '#/components/schemas/ActivityActionUpdatedV2'
        alert_attached_to_incident:
          $ref: '#/components/schemas/ActivityAlertRefV2'
        custom_field_value_update:
          $ref: '#/components/schemas/ActivityCustomFieldValueUpdateV2'
        escalation_acknowledged:
          $ref: '#/components/schemas/ActivityEscalationAcknowledgedV2'
        escalation_created:
          $ref: '#/components/schemas/ActivityEscalationCreatedV2'
        follow_up_created:
          $ref: '#/components/schemas/ActivityFollowUpRefV2'
        follow_up_updated:
          $ref: '#/components/schemas/ActivityFollowUpUpdatedV2'
        incident_merged:
          $ref: '#/components/schemas/ActivityIncidentMergedV2'
        incident_rename:
          $ref: '#/components/schemas/ActivityIncidentRenameV2'
        incident_timestamp_set:
          $ref: '#/components/schemas/ActivityIncidentTimestampSetV2'
        incident_type_changed:
          $ref: '#/components/schemas/ActivityIncidentTypeChangedV2'
        incident_update:
          $ref: '#/components/schemas/ActivityIncidentUpdateV2'
        incident_visibility_changed:
          $ref: '#/components/schemas/ActivityIncidentVisibilityChangedV2'
        role_update:
          $ref: '#/components/schemas/ActivityRoleUpdateV2'
        status_change:
          $ref: '#/components/schemas/ActivityStatusChangeV2'
        summary_update:
          $ref: '#/components/schemas/ActivitySummaryUpdateV2'
        workflow_ran:
          $ref: '#/components/schemas/ActivityWorkflowRanV2'
      type: object
    ErrorSource:
      example:
        field: default_call_url
        pointer: /settings/default_call_url
      properties:
        field:
          description: Field name that is the source of the error
          example: default_call_url
          type: string
        pointer:
          description: JSON pointer to the request field that is the source of the error
          example: /settings/default_call_url
          type: string
      required:
        - field
        - pointer
      type: object
    ActivityActionRefV2:
      example:
        action_id: 01FCNDV6P870EA6S7TK1DSYDG0
        actor:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        action_id:
          description: The action. Fetch it from GET /v2/actions/{id}.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        actor:
          $ref: '#/components/schemas/ActorV2'
      required:
        - action_id
      type: object
    ActivityActionUpdatedV2:
      example:
        action_id: 01FCNDV6P870EA6S7TK1DSYDG0
        new_assignee:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        new_status: completed
        previous_assignee:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        previous_status: outstanding
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        action_id:
          description: The action that changed. Fetch it from GET /v2/actions/{id}.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        new_assignee:
          $ref: '#/components/schemas/UserV2'
        new_status:
          description: Status after, when the status changed
          enum:
            - outstanding
            - completed
            - deleted
            - not_doing
          example: completed
          type: string
        previous_assignee:
          $ref: '#/components/schemas/UserV2'
        previous_status:
          description: Status before, when the status changed
          enum:
            - outstanding
            - completed
            - deleted
            - not_doing
          example: outstanding
          type: string
        updater:
          $ref: '#/components/schemas/ActorV2'
      required:
        - action_id
      type: object
    ActivityAlertRefV2:
      example:
        actor:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
        alert_id: 01FCNDV6P870EA6S7TK1DSYDG0
      properties:
        actor:
          $ref: '#/components/schemas/ActorV2'
        alert_id:
          description: The alert. Fetch it from GET /v2/alerts/{id}.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
      required:
        - alert_id
      type: object
    ActivityCustomFieldValueUpdateV2:
      example:
        custom_field:
          description: Which team is impacted by this issue
          field_type: single_select
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Affected Team
          options:
            - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              sort_key: 10
              value: Product
        new_values:
          - value_catalog_entry:
              aliases:
                - lawrence@incident.io
                - lawrence
              external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Primary On-call
            value_link: https://google.com/
            value_numeric: '123.456'
            value_option:
              custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              sort_key: 10
              value: Product
            value_text: This is my text field, I hope you like it
        new_values_count: 4
        previous_values:
          - value_catalog_entry:
              aliases:
                - lawrence@incident.io
                - lawrence
              external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Primary On-call
            value_link: https://google.com/
            value_numeric: '123.456'
            value_option:
              custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              sort_key: 10
              value: Product
            value_text: This is my text field, I hope you like it
        previous_values_count: 3
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        custom_field:
          $ref: '#/components/schemas/CustomFieldTypeInfoV2'
        new_values:
          description: Values after the change, up to 100 of them
          example:
            - value_catalog_entry:
                aliases:
                  - lawrence@incident.io
                  - lawrence
                external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                name: Primary On-call
              value_link: https://google.com/
              value_numeric: '123.456'
              value_option:
                custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                sort_key: 10
                value: Product
              value_text: This is my text field, I hope you like it
          items:
            $ref: '#/components/schemas/CustomFieldValueV2'
          type: array
        new_values_count:
          description: How many values there are now, which can exceed the array above
          example: 4
          format: int64
          type: integer
        previous_values:
          description: Values before the change, up to 100 of them
          example:
            - value_catalog_entry:
                aliases:
                  - lawrence@incident.io
                  - lawrence
                external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                name: Primary On-call
              value_link: https://google.com/
              value_numeric: '123.456'
              value_option:
                custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
                id: 01FCNDV6P870EA6S7TK1DSYDG0
                sort_key: 10
                value: Product
              value_text: This is my text field, I hope you like it
          items:
            $ref: '#/components/schemas/CustomFieldValueV2'
          type: array
        previous_values_count:
          description: How many values there were before, which can exceed the array above
          example: 3
          format: int64
          type: integer
        updater:
          $ref: '#/components/schemas/ActorV2'
      type: object
    ActivityEscalationAcknowledgedV2:
      example:
        acknowledger:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
      properties:
        acknowledger:
          $ref: '#/components/schemas/UserV2'
        escalation_id:
          description: The escalation that was acknowledged
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
      required:
        - escalation_id
      type: object
    ActivityEscalationCreatedV2:
      example:
        creator:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
        escalated_to_users:
          - email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
        escalation_id: 01FCNDV6P870EA6S7TK1DSYDG0
        escalation_path_id: 01FCNDV6P870EA6S7TK1DSYDG1
      properties:
        creator:
          $ref: '#/components/schemas/ActorV2'
        escalated_to_users:
          description: Users this escalation paged
          example:
            - email: lisa@incident.io
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              name: Lisa Karlin Curtis
              role: owner
              slack_user_id: U02AYNF2XJM
          items:
            $ref: '#/components/schemas/UserV2'
          type: array
        escalation_id:
          description: The escalation. Fetch it from GET /v2/escalations/{id}.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        escalation_path_id:
          description: The escalation path used, when one was
          example: 01FCNDV6P870EA6S7TK1DSYDG1
          type: string
      required:
        - escalation_id
      type: object
    ActivityFollowUpRefV2:
      example:
        actor:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
        follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
      properties:
        actor:
          $ref: '#/components/schemas/ActorV2'
        follow_up_id:
          description: The follow-up. Fetch it from GET /v2/follow_ups/{id}.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
      required:
        - follow_up_id
      type: object
    ActivityFollowUpUpdatedV2:
      example:
        follow_up_id: 01FCNDV6P870EA6S7TK1DSYDG0
        new_assignee:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        new_status: completed
        new_title: Add a payments-api rollback runbook
        previous_assignee:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        previous_status: outstanding
        previous_title: Add a runbook
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        follow_up_id:
          description: The follow-up that changed. Fetch it from GET /v2/follow_ups/{id}.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        new_assignee:
          $ref: '#/components/schemas/UserV2'
        new_status:
          description: Status after, when the status changed
          enum:
            - outstanding
            - completed
            - deleted
            - not_doing
          example: completed
          type: string
        new_title:
          description: Title after, when the title changed
          example: Add a payments-api rollback runbook
          type: string
        previous_assignee:
          $ref: '#/components/schemas/UserV2'
        previous_status:
          description: Status before, when the status changed
          enum:
            - outstanding
            - completed
            - deleted
            - not_doing
          example: outstanding
          type: string
        previous_title:
          description: Title before, when the title changed
          example: Add a runbook
          type: string
        updater:
          $ref: '#/components/schemas/ActorV2'
      required:
        - follow_up_id
      type: object
    ActivityIncidentMergedV2:
      example:
        incident_update_id: 01FCNDV6P870EA6S7TK1DSYDG0
        merger:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
        source_incident:
          external_id: 123
          id: 01FDAG4SAP5TYPT98WGR2N7W91
          name: Our database is sad
          reference: INC-123
          status_category: triage
          summary: Our database is really really sad, and we don't know why yet.
          visibility: public
      properties:
        incident_update_id:
          description: >-
            The incident update that carried the merge. Absent on merges
            recorded before December 2025.
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        merger:
          $ref: '#/components/schemas/ActorV2'
        source_incident:
          $ref: '#/components/schemas/IncidentSlimV2'
      type: object
    ActivityIncidentRenameV2:
      example:
        new_name: EU checkout failing after 14:02 deploy
        previous_name: Checkout errors
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        new_name:
          description: The incident's name after the rename
          example: EU checkout failing after 14:02 deploy
          type: string
        previous_name:
          description: The incident's name before the rename
          example: Checkout errors
          type: string
        updater:
          $ref: '#/components/schemas/ActorV2'
      required:
        - previous_name
        - new_name
      type: object
    ActivityIncidentTimestampSetV2:
      example:
        incident_timestamp:
          id: 01FCNDV6P870EA6S7TK1DSYD5H
          name: Impact started
          rank: 1
        new_value: '2026-09-01T13:42:00Z'
        previous_value: '2026-09-01T14:00:00Z'
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        incident_timestamp:
          $ref: '#/components/schemas/IncidentTimestampV2'
        new_value:
          description: What it was set to
          example: '2026-09-01T13:42:00Z'
          format: date-time
          type: string
        previous_value:
          description: What it was before. Absent when it was previously unset.
          example: '2026-09-01T14:00:00Z'
          format: date-time
          type: string
        updater:
          $ref: '#/components/schemas/ActorV2'
      required:
        - incident_timestamp
        - new_value
      type: object
    ActivityIncidentTypeChangedV2:
      example:
        new_incident_type:
          create_in_triage: always
          created_at: '2021-08-17T13:28:57.801578Z'
          description: Customer facing production outages
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          is_default: false
          name: Production Outage
          private_incidents_only: false
          updated_at: '2021-08-17T13:28:57.801578Z'
        previous_incident_type:
          create_in_triage: always
          created_at: '2021-08-17T13:28:57.801578Z'
          description: Customer facing production outages
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          is_default: false
          name: Production Outage
          private_incidents_only: false
          updated_at: '2021-08-17T13:28:57.801578Z'
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        new_incident_type:
          $ref: '#/components/schemas/IncidentTypeV2'
        previous_incident_type:
          $ref: '#/components/schemas/IncidentTypeV2'
        updater:
          $ref: '#/components/schemas/ActorV2'
      type: object
    ActivityIncidentUpdateV2:
      example:
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        message: Rolled back **payments-api** to v411, error rate recovering.
        new_severity:
          created_at: '2021-08-17T13:28:57.801578Z'
          description: Issues with **low impact**.
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Minor
          rank: 1
          updated_at: '2021-08-17T13:28:57.801578Z'
        new_status:
          category: triage
          created_at: '2021-08-17T13:28:57.801578Z'
          description: >-
            Impact has been **fully mitigated**, and we're ready to learn from
            this incident.
          id: 01FCNDV6P870EA6S7TK1DSYD5H
          name: Closed
          rank: 4
          updated_at: '2021-08-17T13:28:57.801578Z'
        next_update_in_minutes: 30
        previous_severity:
          created_at: '2021-08-17T13:28:57.801578Z'
          description: Issues with **low impact**.
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Minor
          rank: 1
          updated_at: '2021-08-17T13:28:57.801578Z'
        previous_status:
          category: triage
          created_at: '2021-08-17T13:28:57.801578Z'
          description: >-
            Impact has been **fully mitigated**, and we're ready to learn from
            this incident.
          id: 01FCNDV6P870EA6S7TK1DSYD5H
          name: Closed
          rank: 4
          updated_at: '2021-08-17T13:28:57.801578Z'
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        id:
          description: ID of the incident update
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        message:
          description: The update the responder wrote, in markdown
          example: Rolled back **payments-api** to v411, error rate recovering.
          type: string
        new_severity:
          $ref: '#/components/schemas/SeverityV2'
        new_status:
          $ref: '#/components/schemas/IncidentStatusV2'
        next_update_in_minutes:
          description: When the responder said the next update would come
          example: 30
          format: int64
          type: integer
        previous_severity:
          $ref: '#/components/schemas/SeverityV2'
        previous_status:
          $ref: '#/components/schemas/IncidentStatusV2'
        updater:
          $ref: '#/components/schemas/ActorV2'
      required:
        - id
      type: object
    ActivityIncidentVisibilityChangedV2:
      example:
        new_visibility: private
        previous_visibility: public
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        new_visibility:
          description: Visibility after the change
          enum:
            - public
            - private
          example: private
          type: string
        previous_visibility:
          description: Visibility before the change
          enum:
            - public
            - private
          example: public
          type: string
        updater:
          $ref: '#/components/schemas/ActorV2'
      required:
        - previous_visibility
        - new_visibility
      type: object
    ActivityRoleUpdateV2:
      example:
        new_assignee:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        previous_assignee:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        role:
          created_at: '2021-08-17T13:28:57.801578Z'
          description: The person currently coordinating the incident
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          instructions: >-
            Take point on the incident; Make sure people are clear on
            responsibilities
          name: Incident Lead
          role_type: lead
          shortform: lead
          updated_at: '2021-08-17T13:28:57.801578Z'
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        new_assignee:
          $ref: '#/components/schemas/UserV2'
        previous_assignee:
          $ref: '#/components/schemas/UserV2'
        role:
          $ref: '#/components/schemas/IncidentRoleV2'
        updater:
          $ref: '#/components/schemas/ActorV2'
      type: object
    ActivityStatusChangeV2:
      example:
        new_status:
          category: triage
          created_at: '2021-08-17T13:28:57.801578Z'
          description: >-
            Impact has been **fully mitigated**, and we're ready to learn from
            this incident.
          id: 01FCNDV6P870EA6S7TK1DSYD5H
          name: Closed
          rank: 4
          updated_at: '2021-08-17T13:28:57.801578Z'
        previous_status:
          category: triage
          created_at: '2021-08-17T13:28:57.801578Z'
          description: >-
            Impact has been **fully mitigated**, and we're ready to learn from
            this incident.
          id: 01FCNDV6P870EA6S7TK1DSYD5H
          name: Closed
          rank: 4
          updated_at: '2021-08-17T13:28:57.801578Z'
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        new_status:
          $ref: '#/components/schemas/IncidentStatusV2'
        previous_status:
          $ref: '#/components/schemas/IncidentStatusV2'
        updater:
          $ref: '#/components/schemas/ActorV2'
      type: object
    ActivitySummaryUpdateV2:
      example:
        new_summary: Checkout is failing for all EU customers since the 14:02 deploy.
        previous_summary: Checkout is failing for some customers.
        updater:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
      properties:
        new_summary:
          description: The summary after this change, in markdown
          example: Checkout is failing for all EU customers since the 14:02 deploy.
          type: string
        previous_summary:
          description: The summary before this change, in markdown
          example: Checkout is failing for some customers.
          type: string
        updater:
          $ref: '#/components/schemas/ActorV2'
      type: object
    ActivityWorkflowRanV2:
      example:
        creator:
          alert:
            id: 01GW2G3V0S59R238FAHPDS1R66
            title: '*errors.withMessage: PG::Error failed to connect'
          api_key:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My test API key
          user:
            email: lisa@incident.io
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: Lisa Karlin Curtis
            role: owner
            slack_user_id: U02AYNF2XJM
          workflow:
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            name: My little workflow
        event_description: Stopped the synthetic load test in staging.
        event_title: Load test halted
      properties:
        creator:
          $ref: '#/components/schemas/ActorV2'
        event_description:
          description: Description of the event the workflow added, in markdown
          example: Stopped the synthetic load test in staging.
          type: string
        event_title:
          description: Title of the event the workflow added
          example: Load test halted
          type: string
      required:
        - event_title
      type: object
    ActorV2:
      example:
        alert:
          id: 01GW2G3V0S59R238FAHPDS1R66
          title: '*errors.withMessage: PG::Error failed to connect'
        api_key:
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: My test API key
        user:
          email: lisa@incident.io
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Lisa Karlin Curtis
          role: owner
          slack_user_id: U02AYNF2XJM
        workflow:
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: My little workflow
      properties:
        alert:
          $ref: '#/components/schemas/AlertActorV2'
        api_key:
          $ref: '#/components/schemas/APIKeyActorV2'
        user:
          $ref: '#/components/schemas/UserV2'
        workflow:
          $ref: '#/components/schemas/WorkflowActorV2'
      type: object
    UserV2:
      example:
        email: lisa@incident.io
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        name: Lisa Karlin Curtis
        role: owner
        slack_user_id: U02AYNF2XJM
      properties:
        email:
          description: Email address of the user.
          example: lisa@incident.io
          type: string
        id:
          description: Unique identifier of the user
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        name:
          description: Name of the user
          example: Lisa Karlin Curtis
          type: string
        role:
          description: >-
            DEPRECATED: Role of the user as of March 9th 2023, this value is no
            longer updated.
          enum:
            - viewer
            - responder
            - administrator
            - owner
            - unset
          example: owner
          type: string
        slack_user_id:
          description: Slack ID of the user
          example: U02AYNF2XJM
          type: string
      required:
        - role
        - id
        - name
      type: object
    CustomFieldTypeInfoV2:
      example:
        description: Which team is impacted by this issue
        field_type: single_select
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        name: Affected Team
        options:
          - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
            id: 01FCNDV6P870EA6S7TK1DSYDG0
            sort_key: 10
            value: Product
      properties:
        description:
          description: Description of the custom field
          example: Which team is impacted by this issue
          type: string
        field_type:
          description: Type of custom field
          enum:
            - single_select
            - multi_select
            - text
            - link
            - numeric
          example: single_select
          type: string
        id:
          description: Unique identifier for the custom field
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        name:
          description: Human readable name for the custom field
          example: Affected Team
          maxLength: 50
          type: string
        options:
          description: >-
            What options are available for this custom field, if this field has
            options
          example:
            - custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
              id: 01FCNDV6P870EA6S7TK1DSYDG0
              sort_key: 10
              value: Product
          items:
            $ref: '#/components/schemas/CustomFieldOptionV2'
          type: array
      required:
        - id
        - name
        - description
        - field_type
        - options
      type: object
    CustomFieldValueV2:
      example:
        value_catalog_entry:
          aliases:
            - lawrence@incident.io
            - lawrence
          external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          name: Primary On-call
        value_link: https://google.com/
        value_numeric: '123.456'
        value_option:
          custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
          id: 01FCNDV6P870EA6S7TK1DSYDG0
          sort_key: 10
          value: Product
        value_text: This is my text field, I hope you like it
      properties:
        value_catalog_entry:
          $ref: '#/components/schemas/EmbeddedCatalogEntryV2'
        value_link:
          description: >-
            If the custom field type is 'link', this will contain the value
            assigned.
          example: https://google.com/
          type: string
        value_numeric:
          description: >-
            If the custom field type is 'numeric', this will contain the value
            assigned.
          example: '123.456'
          type: string
        value_option:
          $ref: '#/components/schemas/CustomFieldOptionV2'
        value_text:
          description: >-
            If the custom field type is 'text', this will contain the value
            assigned.
          example: This is my text field, I hope you like it
          type: string
      type: object
    IncidentSlimV2:
      description: >-
        Incident slim is a subset of the full incident object, listing key
        fields.
      example:
        external_id: 123
        id: 01FDAG4SAP5TYPT98WGR2N7W91
        name: Our database is sad
        reference: INC-123
        status_category: triage
        summary: Our database is really really sad, and we don't know why yet.
        visibility: public
      properties:
        external_id:
          description: >-
            External identifier for the incident - often displayed with an INC-
            prefix
          example: 123
          format: int64
          type: integer
        id:
          description: Unique identifier for the incident
          example: 01FDAG4SAP5TYPT98WGR2N7W91
          type: string
        name:
          description: Explanation of the incident
          example: Our database is sad
          type: string
        reference:
          description: Reference to this incident, as displayed across the product
          example: INC-123
          type: string
        status_category:
          description: The category of the incidents status
          enum:
            - triage
            - declined
            - merged
            - canceled
            - active
            - post-incident
            - closed
            - paused
          example: triage
          type: string
        summary:
          description: Detailed description of the incident
          example: Our database is really really sad, and we don't know why yet.
          type: string
        visibility:
          description: >-
            Whether the incident should be open to anyone in your Slack
            workspace (public), or invite-only (private). For more information
            on Private Incidents see our
            [docs](https://docs.incident.io/incidents/sensitive-incidents).
          enum:
            - public
            - private
          example: public
          type: string
      required:
        - id
        - external_id
        - name
        - reference
        - visibility
        - status_category
      type: object
    IncidentTimestampV2:
      properties:
        id:
          description: Unique ID of this incident timestamp
          example: 01FCNDV6P870EA6S7TK1DSYD5H
          type: string
        name:
          description: Unique name of this timestamp
          example: Impact started
          type: string
        rank:
          description: Order in which this timestamp should be shown
          example: 1
          format: int64
          type: integer
      required:
        - id
        - name
        - rank
      type: object
    IncidentTypeV2:
      example:
        create_in_triage: always
        created_at: '2021-08-17T13:28:57.801578Z'
        description: Customer facing production outages
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        is_default: false
        name: Production Outage
        private_incidents_only: false
        updated_at: '2021-08-17T13:28:57.801578Z'
      properties:
        create_in_triage:
          description: >-
            Whether incidents of this must always, or can optionally, be created
            in triage
          enum:
            - always
            - optional
          example: always
          type: string
        created_at:
          description: When this resource was created
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
        description:
          description: What is this incident type for?
          example: Customer facing production outages
          type: string
        id:
          description: Unique identifier for this Incident Type
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        is_default:
          description: >-
            The default Incident Type is used when no other type is explicitly
            specified
          example: false
          type: boolean
        name:
          description: The name of this Incident Type
          example: Production Outage
          type: string
        private_incidents_only:
          description: Should all incidents created with this Incident Type be private?
          example: false
          type: boolean
        updated_at:
          description: When this resource was last updated
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
      required:
        - id
        - name
        - is_default
        - description
        - private_incidents_only
        - created_at
        - updated_at
        - create_in_triage
      type: object
    SeverityV2:
      example:
        created_at: '2021-08-17T13:28:57.801578Z'
        description: Issues with **low impact**.
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        name: Minor
        rank: 1
        updated_at: '2021-08-17T13:28:57.801578Z'
      properties:
        created_at:
          description: When the action was created
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
        description:
          description: Description of the severity
          example: Issues with **low impact**.
          type: string
        id:
          description: Unique identifier of the severity
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        name:
          description: Human readable name of the severity
          example: Minor
          maxLength: 50
          type: string
        rank:
          description: Rank to help sort severities (lower numbers are less severe)
          example: 1
          format: int64
          type: integer
        updated_at:
          description: When the action was last updated
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
      required:
        - id
        - name
        - description
        - rank
        - created_at
        - updated_at
      type: object
    IncidentStatusV2:
      example:
        category: triage
        created_at: '2021-08-17T13:28:57.801578Z'
        description: >-
          Impact has been **fully mitigated**, and we're ready to learn from
          this incident.
        id: 01FCNDV6P870EA6S7TK1DSYD5H
        name: Closed
        rank: 4
        updated_at: '2021-08-17T13:28:57.801578Z'
      properties:
        category:
          description: >-
            What category of status it is. All statuses apart from live (renamed
            in the app to Active) and learning (renamed in the app to
            Post-incident) are managed by incident.io and cannot be configured
          enum:
            - triage
            - declined
            - merged
            - canceled
            - live
            - learning
            - closed
            - paused
          example: triage
          type: string
        created_at:
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
        description:
          description: Rich text description of the incident status
          example: >-
            Impact has been **fully mitigated**, and we're ready to learn from
            this incident.
          type: string
        id:
          description: Unique ID of this incident status
          example: 01FCNDV6P870EA6S7TK1DSYD5H
          type: string
        name:
          description: Unique name of this status
          example: Closed
          type: string
        rank:
          description: Order of this incident status
          example: 4
          format: int64
          type: integer
        updated_at:
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
      required:
        - id
        - name
        - description
        - rank
        - category
        - created_at
        - updated_at
      type: object
    IncidentRoleV2:
      properties:
        created_at:
          description: When the role was created
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
        description:
          description: Describes the purpose of the role
          example: The person currently coordinating the incident
          minLength: 1
          type: string
        id:
          description: Unique identifier for the role
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        instructions:
          description: >-
            Provided to whoever is nominated for the role. Note that this will
            be empty for the 'reporter' role.
          example: >-
            Take point on the incident; Make sure people are clear on
            responsibilities
          type: string
        name:
          description: Human readable name of the incident role
          example: Incident Lead
          minLength: 1
          type: string
        role_type:
          description: Type of incident role
          enum:
            - lead
            - reporter
            - custom
          example: lead
          type: string
        shortform:
          description: >-
            Short human readable name for Slack. Note that this will be empty
            for the 'reporter' role.
          example: lead
          type: string
        updated_at:
          description: When the role was last updated
          example: '2021-08-17T13:28:57.801578Z'
          format: date-time
          type: string
      required:
        - name
        - shortform
        - description
        - instructions
        - id
        - role_type
        - created_at
        - updated_at
      type: object
    AlertActorV2:
      example:
        id: 01GW2G3V0S59R238FAHPDS1R66
        title: '*errors.withMessage: PG::Error failed to connect'
      properties:
        id:
          description: The ID of this alert
          example: 01GW2G3V0S59R238FAHPDS1R66
          type: string
        title:
          description: >-
            The title of the alert, parsed from the alert payload according to
            the alert source configuration
          example: '*errors.withMessage: PG::Error failed to connect'
          type: string
      required:
        - id
        - title
      type: object
    APIKeyActorV2:
      example:
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        name: My test API key
      properties:
        id:
          description: Unique identifier for this API key
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        name:
          description: The name of the API key, for the user's reference
          example: My test API key
          type: string
      required:
        - id
        - name
      type: object
    WorkflowActorV2:
      example:
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        name: My little workflow
      properties:
        id:
          description: Unique identifier for the workflow
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        name:
          description: Name provided by the user when creating the workflow
          example: My little workflow
          type: string
      required:
        - id
        - name
      type: object
    CustomFieldOptionV2:
      example:
        custom_field_id: 01FCNDV6P870EA6S7TK1DSYDG0
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        sort_key: 10
        value: Product
      properties:
        custom_field_id:
          description: ID of the custom field this option belongs to
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        id:
          description: Unique identifier for the custom field option
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        sort_key:
          default: 1000
          description: Sort key used to order the custom field options correctly
          example: 10
          format: int64
          type: integer
        value:
          description: >-
            Human readable name for the custom field option. Values must not
            start or end with whitespace, or contain tabs or newlines.
          example: Product
          type: string
      required:
        - id
        - custom_field_id
        - value
        - sort_key
      type: object
    EmbeddedCatalogEntryV2:
      example:
        aliases:
          - lawrence@incident.io
          - lawrence
        external_id: 761722cd-d1d7-477b-ac7e-90f9e079dc33
        id: 01FCNDV6P870EA6S7TK1DSYDG0
        name: Primary On-call
      properties:
        aliases:
          description: Optional aliases that can be used to reference this entry
          example:
            - lawrence@incident.io
            - lawrence
          items:
            example: abc123
            type: string
          type: array
        external_id:
          description: >-
            An optional alternative ID for this entry, which is ensured to be
            unique for the type
          example: 761722cd-d1d7-477b-ac7e-90f9e079dc33
          type: string
        id:
          description: ID of this catalog entry
          example: 01FCNDV6P870EA6S7TK1DSYDG0
          type: string
        name:
          description: Name is the human readable name of this entry
          example: Primary On-call
          type: string
      required:
        - id
        - name
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key from your incident.io dashboard (Settings → API keys)

````