Meetings

List Meetings

Lists the meeting records.

GET
/meetings.list
AuthorizationBearer <token>

All the DevRev APIs require a token to authenticate the user. Provide Authorization: Bearer <TOKEN> as a header to every API request. How do I find my token?

In: header

Query Parameters

channel?array<meeting-channel>

Filters for meeting on specified channels.

created_by?array<string>

Filters for meetings created by the specified user(s).

cursor?string

The cursor to resume iteration from. If not provided, then iteration starts from the beginning.

Formattext
external_ref?array<string>

Filters for meetings with the provided external_ref(s).

limit?integer

The maximum number of meetings to return.

Formatint32
links.link_type?string

Filters for link type in links associated with the meeting.

Formattext
links.target?string

Filters for target id in links associated with the meeting.

Formatid
links.target_object_type?string

Filters for target object type in links associated with the meeting.

Formattext
members?array<string>

Filter for meeting on specified Member Ids.

mode?string

The iteration mode to use, otherwise if not set, then "after" is used.

Value in"after" | "before"
organizer?array<string>

Filter for meeting on specified organizers.

parent?array<string>Deprecated

Filters for meetings with the provided parent.

sort_by?array<string>

Fields to sort the meetings by and the direction to sort them.

state?array<meeting-state>

Filters for meeting on specified state or outcomes.

subtype?array<string>

Subtypes of meeting to be filtered.

sync_metadata.external_reference?array<string>

Filters for issues with this specific external reference.

sync_metadata.last_sync_in.status?array<sync-metadata-filter-sync-in-filter-status>

Filters for works with selected sync statuses.

sync_metadata.last_sync_in.sync_history?array<string>

Filters for works modified with selected sync history.

sync_metadata.last_sync_in.sync_unit?array<string>

Filters for works modified with selected sync units.

sync_metadata.last_sync_out.status?array<sync-metadata-filter-sync-out-filter-status>

Filters for works with selected sync statuses.

sync_metadata.last_sync_out.sync_history?array<string>

Filters for works modified with selected sync history.

sync_metadata.last_sync_out.sync_unit?array<string>

Filters for works modified with selected sync units.

sync_metadata.origin_system?array<string>

Filters for issues synced from this specific origin system.

Response Body

curl -X GET "https://api.devrev.ai/meetings.list?channel=amazon_connect&created_by=string&cursor=string&external_ref=string&limit=0&links.link_type=string&links.target=string&links.target_object_type=string&members=string&mode=after&organizer=string&parent=ACC-12345&sort_by=string&state=canceled&subtype=string&sync_metadata.external_reference=string&sync_metadata.last_sync_in.status=failed&sync_metadata.last_sync_in.sync_history=string&sync_metadata.last_sync_in.sync_unit=string&sync_metadata.last_sync_out.status=failed&sync_metadata.last_sync_out.sync_history=string&sync_metadata.last_sync_out.sync_unit=string&sync_metadata.origin_system=string"
{
  "meetings": [
    {
      "created_by": {
        "type": "dev_user",
        "display_id": "string",
        "id": "string",
        "display_name": "string",
        "display_picture": {
          "display_id": "string",
          "id": "string",
          "file": {
            "type": "string",
            "name": "string",
            "size": 0
          }
        },
        "email": "string",
        "full_name": "string",
        "state": "active"
      },
      "created_date": "2023-01-01T12:00:00.000Z",
      "display_id": "string",
      "id": "string",
      "modified_by": {
        "type": "dev_user",
        "display_id": "string",
        "id": "string",
        "display_name": "string",
        "display_picture": {
          "display_id": "string",
          "id": "string",
          "file": {
            "type": "string",
            "name": "string",
            "size": 0
          }
        },
        "email": "string",
        "full_name": "string",
        "state": "active"
      },
      "modified_date": "2023-01-01T12:00:00.000Z"
    }
  ],
  "next_cursor": "string",
  "prev_cursor": "string"
}
{
  "detail": "string",
  "message": "string",
  "type": "artifact_already_attached_to_a_parent",
  "existing_parent": "string",
  "is_same": true
}
{
  "detail": "string",
  "message": "string",
  "type": "unauthenticated"
}
{
  "detail": "string",
  "message": "string",
  "type": "forbidden"
}
{
  "detail": "string",
  "message": "string",
  "type": "too_many_requests",
  "retry_after": 0
}
{
  "detail": "string",
  "message": "string",
  "type": "internal_error",
  "reference_id": "string"
}
{
  "detail": "string",
  "message": "string",
  "type": "service_unavailable"
}