Skip to content

events.md

Latest commit

 

History

History
282 lines (271 loc) · 9.88 KB

events.md

File metadata and controls

282 lines (271 loc) · 9.88 KB

Events

An event is created any time a recording changes.

Endpoints:

Get events

  • GET /recordings/2/events.json will return a paginated list of events for the recording with an ID of 2.
Example JSON Response
[
  {
    "id": 1071915468,
    "recording_id": 1069479766,
    "action": "adopted",
    "details": {
      "new_parent_id": 1069479743,
      "parent_id_was": 1069479745,
      "notified_recipient_ids": []
    },
    "created_at": "2026-02-12T06:10:00.159Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "boosts_count": 0,
    "boosts_url": "https://3.basecampapi.com/195539477/buckets/2085958507/recordings/1069479766/events/1071915468/boosts.json"
  },
  {
    "id": 1071915469,
    "recording_id": 1069479766,
    "action": "completed",
    "details": {
      "notified_recipient_ids": []
    },
    "created_at": "2026-02-07T17:43:00.000Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "boosts_count": 0,
    "boosts_url": "https://3.basecampapi.com/195539477/buckets/2085958507/recordings/1069479766/events/1071915469/boosts.json"
  },
  {
    "id": 1071915467,
    "recording_id": 1069479766,
    "action": "adopted",
    "details": {
      "new_parent_id": 1069479745,
      "parent_id_was": 1069479742,
      "notified_recipient_ids": []
    },
    "created_at": "2026-02-06T17:43:00.000Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "boosts_count": 0,
    "boosts_url": "https://3.basecampapi.com/195539477/buckets/2085958507/recordings/1069479766/events/1071915467/boosts.json"
  },
  {
    "id": 1071915466,
    "recording_id": 1069479766,
    "action": "adopted",
    "details": {
      "new_parent_id": 1069479742,
      "parent_id_was": 1069479744,
      "notified_recipient_ids": []
    },
    "created_at": "2026-02-04T17:43:00.000Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "boosts_count": 0,
    "boosts_url": "https://3.basecampapi.com/195539477/buckets/2085958507/recordings/1069479766/events/1071915466/boosts.json"
  },
  {
    "id": 1071915465,
    "recording_id": 1069479766,
    "action": "adopted",
    "details": {
      "new_parent_id": 1069479744,
      "parent_id_was": 1069479741,
      "notified_recipient_ids": []
    },
    "created_at": "2026-02-02T17:43:00.000Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "boosts_count": 0,
    "boosts_url": "https://3.basecampapi.com/195539477/buckets/2085958507/recordings/1069479766/events/1071915465/boosts.json"
  },
  {
    "id": 1071915464,
    "recording_id": 1069479766,
    "action": "adopted",
    "details": {
      "new_parent_id": 1069479741,
      "parent_id_was": 1069479739,
      "notified_recipient_ids": []
    },
    "created_at": "2026-02-02T17:43:00.000Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    },
    "boosts_count": 0,
    "boosts_url": "https://3.basecampapi.com/195539477/buckets/2085958507/recordings/1069479766/events/1071915464/boosts.json"
  },
  {
    "id": 1071915463,
    "recording_id": 1069479766,
    "action": "created",
    "details": {
      "notified_recipient_ids": []
    },
    "created_at": "2026-01-23T17:43:00.000Z",
    "creator": {
      "id": 1049715945,
      "attachable_sgid": "BAh7BkkiC19yYWlscwY6BkVUewdJIglkYXRhBjsAVEkiK2dpZDovL2JjMy9QZXJzb24vMTA0OTcxNTk0NT9leHBpcmVzX2luBjsAVEkiCHB1cgY7AFRJIg9hdHRhY2hhYmxlBjsAVA==--573c6935f53af21625ccfd45e28af57c2bbeff49",
      "name": "Victor Cooper",
      "email_address": null,
      "personable_type": "DummyUser",
      "title": null,
      "bio": null,
      "location": null,
      "created_at": "2026-02-12T06:09:57.025Z",
      "updated_at": "2026-02-12T06:09:57.025Z",
      "admin": false,
      "owner": false,
      "client": false,
      "employee": false,
      "time_zone": "America/Chicago",
      "avatar_url": "https://3.basecampapi.com/195539477/people/BAhpBOlkkT4=--eebbe1ab1b28f5fcf32a1c0ff3644e06931fbcfa/avatar",
      "can_ping": true,
      "can_manage_projects": false,
      "can_manage_people": false,
      "can_access_timesheet": false,
      "can_access_hill_charts": false
    }
  }
]
Copy as cURL
curl -s -H "Authorization: Bearer $ACCESS_TOKEN" https://3.basecampapi.com/$ACCOUNT_ID/recordings/2/events.json

Legacy project-scoped routes

The following project-scoped routes are still supported and will remain available, but flat routes above are the canonical form for new integrations.

  • GET /buckets/1/recordings/2/events.json → Get events