ATattio
Meetings

Update a meeting (overwrite linked records)

Changed on

Replaces a meeting's linked records with the records supplied. Any record which is currently linked and is not in the request is unlinked, including records which Attio linked automatically from the meeting's participants. Passing an empty array unlinks every record. Use the PATCH endpoint to add linked records without removing the records which already exist.

No other meeting fields can be updated. Attio automatically links the meeting participants' companies to the meeting; this behavior is asynchronous, so a company which is linked after this request completes is not removed by it.

This endpoint is in beta. We will aim to avoid breaking changes, but small updates may be made as we roll out to more users.

Required scopes: meeting:read-write, record_permission:read.

Supported token levels: workspace, user.

put/v2/meetings/{meeting_id}

Request

  • Base URL
    https://api.attio.com
  • URL
    https://api.attio.com/v2/meetings/{meeting_id}
  • Auth
    OAuth 2
    Authorization code: https://app.attio.com/authorize
    Token URL: https://app.attio.com/oauth/token scopes: meeting:read-write, record_permission:read

Path parameters

meeting_idstring uuid required

A UUID which identifies the meeting to update.

Example:cb59ab17-ad15-460c-a126-0715617c0853

Request body

Example request

{
  "data": {
    "linked_records": [
      {
        "object": "people",
        "record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ]
  }
}

Response

Success

Example response

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "meeting_id": "cb59ab17-ad15-460c-a126-0715617c0853"
    },
    "title": "Onboarding Session",
    "description": "Getting you up to speed with the platform and answering any questions you have.",
    "start": {
      "datetime": "2027-11-27T14:00:00.000-04:00",
      "timezone": "America/New_York"
    },
    "end": {
      "datetime": "2027-11-27T15:00:00.000-04:00",
      "timezone": "America/New_York"
    },
    "participants": [
      {
        "status": "accepted",
        "email_address": "person@company.com",
        "name": "Simon Mitchell"
      }
    ],
    "linked_records": [
      {
        "object_slug": "people",
        "object_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d",
        "record_id": "891dcbfc-9141-415d-9b2a-2238a6cc012d"
      }
    ],
    "created_at": "2023-01-01T15:00:00.000000000Z",
    "created_by_actor": {
      "type": "workspace-member",
      "id": "50cf242c-7fa3-4cad-87d0-75b1af71c57b"
    }
  }
}

Changes