# Meeting
## Create a meeting
`client.Meeting.New(ctx, body) (*MeetingCreateResponse, error)`
**post** `/v1/meetings`
Creates a new meeting record. This endpoint only supports creation of meetings in the past. The `$title`, `$startDate`, and `$endDate` fields are required. Only the `$transcript` relationship is writable on create; all other meeting relationships are system-managed. The response is privacy-aware and includes a read-only `accessLevel`. See [Uploading meeting transcripts](/using-the-api/uploading-meeting-transcripts/) for the full file upload and transcript attachment flow.
Supports idempotency via the `Idempotency-Key` header.
**[Required scope](/using-the-api/scopes/):** `meetings:create`
**[Rate limit category](/using-the-api/rate-limits/):** Write
### Parameters
- `body MeetingNewParams`
- `Fields param.Field[MeetingNewParamsFields]`
Field values for the new MANUAL meeting. System fields use a `$` prefix (for example `$title`, `$startDate`, `$endDate`). Required: `$title`, `$startDate`, and `$endDate`. `$organizerEmail` accepts a single email address when provided; `$attendeeEmails` accepts an array of email addresses. See [Fields and relationships](/using-the-api/fields-and-relationships/) for value type details.
- `EndDate string`
The end time of the meeting in ISO 8601 format. Must be in the past.
- `StartDate string`
The start time of the meeting in ISO 8601 format. Must be in the past.
- `Title string`
The title of the meeting.
- `AttendeeEmails []string`
A list of attendee email addresses.
- `Description string`
A description of the meeting.
- `MeetingURL string`
The URL for the meeting.
- `OrganizerEmail string`
The email address of the meeting organizer. This field accepts a single email address.
- `PrivacySetting string`
The privacy setting for the meeting (`FULL` or `METADATA`).
- `const MeetingNewParamsFieldsPrivacySettingFull MeetingNewParamsFieldsPrivacySetting = "FULL"`
- `const MeetingNewParamsFieldsPrivacySettingMetadata MeetingNewParamsFieldsPrivacySetting = "METADATA"`
- `AutoCreateRecords param.Field[bool]`
When true, the initial post-create meeting sync may auto-create account and contact records for external attendees.
- `Relationships param.Field[MeetingNewParamsRelationships]`
Relationships to set on the new meeting. Only `$transcript` is writable on create; all other meeting relationships are system-managed.
- `Transcript MeetingNewParamsRelationshipsTranscriptUnion`
The ID of the file to attach as the meeting transcript when creating the meeting. Only one transcript can be attached to a meeting.
- `string`
- `type MeetingNewParamsRelationshipsTranscriptArray []string`
### Returns
- `type MeetingCreateResponse struct{…}`
- `ID string`
Unique identifier for the entity.
- `AccessLevel MeetingCreateResponseAccessLevel`
The caller's resolved access level for this meeting.
- `const MeetingCreateResponseAccessLevelFull MeetingCreateResponseAccessLevel = "FULL"`
- `const MeetingCreateResponseAccessLevelMetadata MeetingCreateResponseAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingCreateResponseField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingCreateResponseFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingCreateResponseFieldValueArray []string`
- `type MeetingCreateResponseFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingCreateResponseFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingCreateResponseFieldValueTypeAddress MeetingCreateResponseFieldValueType = "ADDRESS"`
- `const MeetingCreateResponseFieldValueTypeCheckbox MeetingCreateResponseFieldValueType = "CHECKBOX"`
- `const MeetingCreateResponseFieldValueTypeCurrency MeetingCreateResponseFieldValueType = "CURRENCY"`
- `const MeetingCreateResponseFieldValueTypeDatetime MeetingCreateResponseFieldValueType = "DATETIME"`
- `const MeetingCreateResponseFieldValueTypeEmail MeetingCreateResponseFieldValueType = "EMAIL"`
- `const MeetingCreateResponseFieldValueTypeFullName MeetingCreateResponseFieldValueType = "FULL_NAME"`
- `const MeetingCreateResponseFieldValueTypeMarkdown MeetingCreateResponseFieldValueType = "MARKDOWN"`
- `const MeetingCreateResponseFieldValueTypeMultiSelect MeetingCreateResponseFieldValueType = "MULTI_SELECT"`
- `const MeetingCreateResponseFieldValueTypeNumber MeetingCreateResponseFieldValueType = "NUMBER"`
- `const MeetingCreateResponseFieldValueTypeSingleSelect MeetingCreateResponseFieldValueType = "SINGLE_SELECT"`
- `const MeetingCreateResponseFieldValueTypeSocialHandle MeetingCreateResponseFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingCreateResponseFieldValueTypeTelephone MeetingCreateResponseFieldValueType = "TELEPHONE"`
- `const MeetingCreateResponseFieldValueTypeText MeetingCreateResponseFieldValueType = "TEXT"`
- `const MeetingCreateResponseFieldValueTypeURL MeetingCreateResponseFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType MeetingCreateResponseObjectType`
Always `meeting`.
- `const MeetingCreateResponseObjectTypeMeeting MeetingCreateResponseObjectType = "meeting"`
- `Relationships map[string, MeetingCreateResponseRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
### Example
```go
package main
import (
"context"
"fmt"
"github.com/Lightfld/lightfield-go"
"github.com/Lightfld/lightfield-go/option"
)
func main() {
client := githubcomlightfldlightfieldgo.NewClient(
option.WithAPIKey("My API Key"),
)
meetingCreateResponse, err := client.Meeting.New(context.TODO(), githubcomlightfldlightfieldgo.MeetingNewParams{
Fields: githubcomlightfldlightfieldgo.MeetingNewParamsFields{
EndDate: "$endDate",
StartDate: "$startDate",
Title: "$title",
},
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", meetingCreateResponse.ID)
}
```
#### Response
```json
{
"id": "id",
"accessLevel": "FULL",
"createdAt": "createdAt",
"fields": {
"foo": {
"value": "string",
"valueType": "ADDRESS"
}
},
"httpLink": "httpLink",
"objectType": "meeting",
"relationships": {
"foo": {
"cardinality": "cardinality",
"objectType": "objectType",
"values": [
"string"
]
}
},
"updatedAt": "updatedAt",
"externalId": "externalId"
}
```
## Update a meeting
`client.Meeting.Update(ctx, id, body) (*MeetingUpdateResponse, error)`
**post** `/v1/meetings/{id}`
Updates an existing meeting by ID. Only included fields and relationships are modified.
Only `fields.$privacySetting` and `relationships.$transcript.replace` are writable. Use `$transcript.replace` to set the meeting transcript. Clearing or removing `$transcript` is not supported. The response is privacy-aware and includes a read-only `accessLevel`. See [Uploading meeting transcripts](/using-the-api/uploading-meeting-transcripts/) for the full file upload and transcript attachment flow.
Supports idempotency via the `Idempotency-Key` header.
**[Required scope](/using-the-api/scopes/):** `meetings:update`
**[Rate limit category](/using-the-api/rate-limits/):** Write
### Parameters
- `id string`
Unique identifier of the meeting to update.
- `body MeetingUpdateParams`
- `Fields param.Field[MeetingUpdateParamsFields]`
Field values to update. Only `$privacySetting` is writable, and omitted fields are left unchanged.
- `PrivacySetting string`
The privacy setting for the meeting.
- `const MeetingUpdateParamsFieldsPrivacySettingFull MeetingUpdateParamsFieldsPrivacySetting = "FULL"`
- `const MeetingUpdateParamsFieldsPrivacySettingMetadata MeetingUpdateParamsFieldsPrivacySetting = "METADATA"`
- `Relationships param.Field[MeetingUpdateParamsRelationships]`
Relationship operations to apply. Only `$transcript.replace` is supported; removing or clearing `$transcript` is not supported.
- `Transcript MeetingUpdateParamsRelationshipsTranscript`
- `Replace string`
The file ID to set as the meeting transcript.
### Returns
- `type MeetingUpdateResponse struct{…}`
- `ID string`
Unique identifier for the entity.
- `AccessLevel MeetingUpdateResponseAccessLevel`
The caller's resolved access level for this meeting.
- `const MeetingUpdateResponseAccessLevelFull MeetingUpdateResponseAccessLevel = "FULL"`
- `const MeetingUpdateResponseAccessLevelMetadata MeetingUpdateResponseAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingUpdateResponseField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingUpdateResponseFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingUpdateResponseFieldValueArray []string`
- `type MeetingUpdateResponseFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingUpdateResponseFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingUpdateResponseFieldValueTypeAddress MeetingUpdateResponseFieldValueType = "ADDRESS"`
- `const MeetingUpdateResponseFieldValueTypeCheckbox MeetingUpdateResponseFieldValueType = "CHECKBOX"`
- `const MeetingUpdateResponseFieldValueTypeCurrency MeetingUpdateResponseFieldValueType = "CURRENCY"`
- `const MeetingUpdateResponseFieldValueTypeDatetime MeetingUpdateResponseFieldValueType = "DATETIME"`
- `const MeetingUpdateResponseFieldValueTypeEmail MeetingUpdateResponseFieldValueType = "EMAIL"`
- `const MeetingUpdateResponseFieldValueTypeFullName MeetingUpdateResponseFieldValueType = "FULL_NAME"`
- `const MeetingUpdateResponseFieldValueTypeMarkdown MeetingUpdateResponseFieldValueType = "MARKDOWN"`
- `const MeetingUpdateResponseFieldValueTypeMultiSelect MeetingUpdateResponseFieldValueType = "MULTI_SELECT"`
- `const MeetingUpdateResponseFieldValueTypeNumber MeetingUpdateResponseFieldValueType = "NUMBER"`
- `const MeetingUpdateResponseFieldValueTypeSingleSelect MeetingUpdateResponseFieldValueType = "SINGLE_SELECT"`
- `const MeetingUpdateResponseFieldValueTypeSocialHandle MeetingUpdateResponseFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingUpdateResponseFieldValueTypeTelephone MeetingUpdateResponseFieldValueType = "TELEPHONE"`
- `const MeetingUpdateResponseFieldValueTypeText MeetingUpdateResponseFieldValueType = "TEXT"`
- `const MeetingUpdateResponseFieldValueTypeURL MeetingUpdateResponseFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType MeetingUpdateResponseObjectType`
Always `meeting`.
- `const MeetingUpdateResponseObjectTypeMeeting MeetingUpdateResponseObjectType = "meeting"`
- `Relationships map[string, MeetingUpdateResponseRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
### Example
```go
package main
import (
"context"
"fmt"
"github.com/Lightfld/lightfield-go"
"github.com/Lightfld/lightfield-go/option"
)
func main() {
client := githubcomlightfldlightfieldgo.NewClient(
option.WithAPIKey("My API Key"),
)
meetingUpdateResponse, err := client.Meeting.Update(
context.TODO(),
"id",
githubcomlightfldlightfieldgo.MeetingUpdateParams{
},
)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", meetingUpdateResponse.ID)
}
```
#### Response
```json
{
"id": "id",
"accessLevel": "FULL",
"createdAt": "createdAt",
"fields": {
"foo": {
"value": "string",
"valueType": "ADDRESS"
}
},
"httpLink": "httpLink",
"objectType": "meeting",
"relationships": {
"foo": {
"cardinality": "cardinality",
"objectType": "objectType",
"values": [
"string"
]
}
},
"updatedAt": "updatedAt",
"externalId": "externalId"
}
```
## Retrieve a meeting
`client.Meeting.Get(ctx, id) (*MeetingRetrieveResponse, error)`
**get** `/v1/meetings/{id}`
Retrieves a single meeting by its ID. Meeting fields and transcript visibility are redacted based on the caller-specific privacy resolution, and the response includes a read-only `accessLevel`.
**[Required scope](/using-the-api/scopes/):** `meetings:read`
**[Rate limit category](/using-the-api/rate-limits/):** Read
### Parameters
- `id string`
Unique identifier of the meeting to retrieve.
### Returns
- `type MeetingRetrieveResponse struct{…}`
- `ID string`
Unique identifier for the entity.
- `AccessLevel MeetingRetrieveResponseAccessLevel`
The caller's resolved access level for this meeting.
- `const MeetingRetrieveResponseAccessLevelFull MeetingRetrieveResponseAccessLevel = "FULL"`
- `const MeetingRetrieveResponseAccessLevelMetadata MeetingRetrieveResponseAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingRetrieveResponseField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingRetrieveResponseFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingRetrieveResponseFieldValueArray []string`
- `type MeetingRetrieveResponseFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingRetrieveResponseFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingRetrieveResponseFieldValueTypeAddress MeetingRetrieveResponseFieldValueType = "ADDRESS"`
- `const MeetingRetrieveResponseFieldValueTypeCheckbox MeetingRetrieveResponseFieldValueType = "CHECKBOX"`
- `const MeetingRetrieveResponseFieldValueTypeCurrency MeetingRetrieveResponseFieldValueType = "CURRENCY"`
- `const MeetingRetrieveResponseFieldValueTypeDatetime MeetingRetrieveResponseFieldValueType = "DATETIME"`
- `const MeetingRetrieveResponseFieldValueTypeEmail MeetingRetrieveResponseFieldValueType = "EMAIL"`
- `const MeetingRetrieveResponseFieldValueTypeFullName MeetingRetrieveResponseFieldValueType = "FULL_NAME"`
- `const MeetingRetrieveResponseFieldValueTypeMarkdown MeetingRetrieveResponseFieldValueType = "MARKDOWN"`
- `const MeetingRetrieveResponseFieldValueTypeMultiSelect MeetingRetrieveResponseFieldValueType = "MULTI_SELECT"`
- `const MeetingRetrieveResponseFieldValueTypeNumber MeetingRetrieveResponseFieldValueType = "NUMBER"`
- `const MeetingRetrieveResponseFieldValueTypeSingleSelect MeetingRetrieveResponseFieldValueType = "SINGLE_SELECT"`
- `const MeetingRetrieveResponseFieldValueTypeSocialHandle MeetingRetrieveResponseFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingRetrieveResponseFieldValueTypeTelephone MeetingRetrieveResponseFieldValueType = "TELEPHONE"`
- `const MeetingRetrieveResponseFieldValueTypeText MeetingRetrieveResponseFieldValueType = "TEXT"`
- `const MeetingRetrieveResponseFieldValueTypeURL MeetingRetrieveResponseFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType MeetingRetrieveResponseObjectType`
Always `meeting`.
- `const MeetingRetrieveResponseObjectTypeMeeting MeetingRetrieveResponseObjectType = "meeting"`
- `Relationships map[string, MeetingRetrieveResponseRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
### Example
```go
package main
import (
"context"
"fmt"
"github.com/Lightfld/lightfield-go"
"github.com/Lightfld/lightfield-go/option"
)
func main() {
client := githubcomlightfldlightfieldgo.NewClient(
option.WithAPIKey("My API Key"),
)
meetingRetrieveResponse, err := client.Meeting.Get(context.TODO(), "id")
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", meetingRetrieveResponse.ID)
}
```
#### Response
```json
{
"id": "id",
"accessLevel": "FULL",
"createdAt": "createdAt",
"fields": {
"foo": {
"value": "string",
"valueType": "ADDRESS"
}
},
"httpLink": "httpLink",
"objectType": "meeting",
"relationships": {
"foo": {
"cardinality": "cardinality",
"objectType": "objectType",
"values": [
"string"
]
}
},
"updatedAt": "updatedAt",
"externalId": "externalId"
}
```
## List meetings
`client.Meeting.List(ctx, query) (*MeetingListResponse, error)`
**get** `/v1/meetings`
Returns a paginated list of meetings. Use `offset` and `limit` to paginate through results. Each meeting is privacy-filtered per caller, includes a read-only `accessLevel`, and may redact transcript or content fields based on the caller-specific privacy resolution. See [List endpoints](/using-the-api/list-endpoints/) for more information about pagination.
**[Required scope](/using-the-api/scopes/):** `meetings:read`
**[Rate limit category](/using-the-api/rate-limits/):** Search
### Parameters
- `query MeetingListParams`
- `Limit param.Field[int64]`
Maximum number of records to return. Defaults to 25, maximum 25.
- `Offset param.Field[int64]`
Number of records to skip for pagination. Defaults to 0.
### Returns
- `type MeetingListResponse struct{…}`
- `Data []MeetingListResponseData`
Array of meeting objects for the current page.
- `ID string`
Unique identifier for the entity.
- `AccessLevel string`
The caller's resolved access level for this meeting.
- `const MeetingListResponseDataAccessLevelFull MeetingListResponseDataAccessLevel = "FULL"`
- `const MeetingListResponseDataAccessLevelMetadata MeetingListResponseDataAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingListResponseDataField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingListResponseDataFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingListResponseDataFieldValueArray []string`
- `type MeetingListResponseDataFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingListResponseDataFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingListResponseDataFieldValueTypeAddress MeetingListResponseDataFieldValueType = "ADDRESS"`
- `const MeetingListResponseDataFieldValueTypeCheckbox MeetingListResponseDataFieldValueType = "CHECKBOX"`
- `const MeetingListResponseDataFieldValueTypeCurrency MeetingListResponseDataFieldValueType = "CURRENCY"`
- `const MeetingListResponseDataFieldValueTypeDatetime MeetingListResponseDataFieldValueType = "DATETIME"`
- `const MeetingListResponseDataFieldValueTypeEmail MeetingListResponseDataFieldValueType = "EMAIL"`
- `const MeetingListResponseDataFieldValueTypeFullName MeetingListResponseDataFieldValueType = "FULL_NAME"`
- `const MeetingListResponseDataFieldValueTypeMarkdown MeetingListResponseDataFieldValueType = "MARKDOWN"`
- `const MeetingListResponseDataFieldValueTypeMultiSelect MeetingListResponseDataFieldValueType = "MULTI_SELECT"`
- `const MeetingListResponseDataFieldValueTypeNumber MeetingListResponseDataFieldValueType = "NUMBER"`
- `const MeetingListResponseDataFieldValueTypeSingleSelect MeetingListResponseDataFieldValueType = "SINGLE_SELECT"`
- `const MeetingListResponseDataFieldValueTypeSocialHandle MeetingListResponseDataFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingListResponseDataFieldValueTypeTelephone MeetingListResponseDataFieldValueType = "TELEPHONE"`
- `const MeetingListResponseDataFieldValueTypeText MeetingListResponseDataFieldValueType = "TEXT"`
- `const MeetingListResponseDataFieldValueTypeURL MeetingListResponseDataFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType string`
Always `meeting`.
- `const MeetingListResponseDataObjectTypeMeeting MeetingListResponseDataObjectType = "meeting"`
- `Relationships map[string, MeetingListResponseDataRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
- `Object string`
The object type, always `"list"`.
- `TotalCount int64`
Total number of entities matching the query.
### Example
```go
package main
import (
"context"
"fmt"
"github.com/Lightfld/lightfield-go"
"github.com/Lightfld/lightfield-go/option"
)
func main() {
client := githubcomlightfldlightfieldgo.NewClient(
option.WithAPIKey("My API Key"),
)
meetingListResponse, err := client.Meeting.List(context.TODO(), githubcomlightfldlightfieldgo.MeetingListParams{
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", meetingListResponse.Data)
}
```
#### Response
```json
{
"data": [
{
"id": "id",
"accessLevel": "FULL",
"createdAt": "createdAt",
"fields": {
"foo": {
"value": "string",
"valueType": "ADDRESS"
}
},
"httpLink": "httpLink",
"objectType": "meeting",
"relationships": {
"foo": {
"cardinality": "cardinality",
"objectType": "objectType",
"values": [
"string"
]
}
},
"updatedAt": "updatedAt",
"externalId": "externalId"
}
],
"object": "object",
"totalCount": 0
}
```
## Domain Types
### Meeting Create Response
- `type MeetingCreateResponse struct{…}`
- `ID string`
Unique identifier for the entity.
- `AccessLevel MeetingCreateResponseAccessLevel`
The caller's resolved access level for this meeting.
- `const MeetingCreateResponseAccessLevelFull MeetingCreateResponseAccessLevel = "FULL"`
- `const MeetingCreateResponseAccessLevelMetadata MeetingCreateResponseAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingCreateResponseField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingCreateResponseFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingCreateResponseFieldValueArray []string`
- `type MeetingCreateResponseFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingCreateResponseFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingCreateResponseFieldValueTypeAddress MeetingCreateResponseFieldValueType = "ADDRESS"`
- `const MeetingCreateResponseFieldValueTypeCheckbox MeetingCreateResponseFieldValueType = "CHECKBOX"`
- `const MeetingCreateResponseFieldValueTypeCurrency MeetingCreateResponseFieldValueType = "CURRENCY"`
- `const MeetingCreateResponseFieldValueTypeDatetime MeetingCreateResponseFieldValueType = "DATETIME"`
- `const MeetingCreateResponseFieldValueTypeEmail MeetingCreateResponseFieldValueType = "EMAIL"`
- `const MeetingCreateResponseFieldValueTypeFullName MeetingCreateResponseFieldValueType = "FULL_NAME"`
- `const MeetingCreateResponseFieldValueTypeMarkdown MeetingCreateResponseFieldValueType = "MARKDOWN"`
- `const MeetingCreateResponseFieldValueTypeMultiSelect MeetingCreateResponseFieldValueType = "MULTI_SELECT"`
- `const MeetingCreateResponseFieldValueTypeNumber MeetingCreateResponseFieldValueType = "NUMBER"`
- `const MeetingCreateResponseFieldValueTypeSingleSelect MeetingCreateResponseFieldValueType = "SINGLE_SELECT"`
- `const MeetingCreateResponseFieldValueTypeSocialHandle MeetingCreateResponseFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingCreateResponseFieldValueTypeTelephone MeetingCreateResponseFieldValueType = "TELEPHONE"`
- `const MeetingCreateResponseFieldValueTypeText MeetingCreateResponseFieldValueType = "TEXT"`
- `const MeetingCreateResponseFieldValueTypeURL MeetingCreateResponseFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType MeetingCreateResponseObjectType`
Always `meeting`.
- `const MeetingCreateResponseObjectTypeMeeting MeetingCreateResponseObjectType = "meeting"`
- `Relationships map[string, MeetingCreateResponseRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
### Meeting List Response
- `type MeetingListResponse struct{…}`
- `Data []MeetingListResponseData`
Array of meeting objects for the current page.
- `ID string`
Unique identifier for the entity.
- `AccessLevel string`
The caller's resolved access level for this meeting.
- `const MeetingListResponseDataAccessLevelFull MeetingListResponseDataAccessLevel = "FULL"`
- `const MeetingListResponseDataAccessLevelMetadata MeetingListResponseDataAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingListResponseDataField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingListResponseDataFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingListResponseDataFieldValueArray []string`
- `type MeetingListResponseDataFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingListResponseDataFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingListResponseDataFieldValueTypeAddress MeetingListResponseDataFieldValueType = "ADDRESS"`
- `const MeetingListResponseDataFieldValueTypeCheckbox MeetingListResponseDataFieldValueType = "CHECKBOX"`
- `const MeetingListResponseDataFieldValueTypeCurrency MeetingListResponseDataFieldValueType = "CURRENCY"`
- `const MeetingListResponseDataFieldValueTypeDatetime MeetingListResponseDataFieldValueType = "DATETIME"`
- `const MeetingListResponseDataFieldValueTypeEmail MeetingListResponseDataFieldValueType = "EMAIL"`
- `const MeetingListResponseDataFieldValueTypeFullName MeetingListResponseDataFieldValueType = "FULL_NAME"`
- `const MeetingListResponseDataFieldValueTypeMarkdown MeetingListResponseDataFieldValueType = "MARKDOWN"`
- `const MeetingListResponseDataFieldValueTypeMultiSelect MeetingListResponseDataFieldValueType = "MULTI_SELECT"`
- `const MeetingListResponseDataFieldValueTypeNumber MeetingListResponseDataFieldValueType = "NUMBER"`
- `const MeetingListResponseDataFieldValueTypeSingleSelect MeetingListResponseDataFieldValueType = "SINGLE_SELECT"`
- `const MeetingListResponseDataFieldValueTypeSocialHandle MeetingListResponseDataFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingListResponseDataFieldValueTypeTelephone MeetingListResponseDataFieldValueType = "TELEPHONE"`
- `const MeetingListResponseDataFieldValueTypeText MeetingListResponseDataFieldValueType = "TEXT"`
- `const MeetingListResponseDataFieldValueTypeURL MeetingListResponseDataFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType string`
Always `meeting`.
- `const MeetingListResponseDataObjectTypeMeeting MeetingListResponseDataObjectType = "meeting"`
- `Relationships map[string, MeetingListResponseDataRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
- `Object string`
The object type, always `"list"`.
- `TotalCount int64`
Total number of entities matching the query.
### Meeting Retrieve Response
- `type MeetingRetrieveResponse struct{…}`
- `ID string`
Unique identifier for the entity.
- `AccessLevel MeetingRetrieveResponseAccessLevel`
The caller's resolved access level for this meeting.
- `const MeetingRetrieveResponseAccessLevelFull MeetingRetrieveResponseAccessLevel = "FULL"`
- `const MeetingRetrieveResponseAccessLevelMetadata MeetingRetrieveResponseAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingRetrieveResponseField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingRetrieveResponseFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingRetrieveResponseFieldValueArray []string`
- `type MeetingRetrieveResponseFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingRetrieveResponseFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingRetrieveResponseFieldValueTypeAddress MeetingRetrieveResponseFieldValueType = "ADDRESS"`
- `const MeetingRetrieveResponseFieldValueTypeCheckbox MeetingRetrieveResponseFieldValueType = "CHECKBOX"`
- `const MeetingRetrieveResponseFieldValueTypeCurrency MeetingRetrieveResponseFieldValueType = "CURRENCY"`
- `const MeetingRetrieveResponseFieldValueTypeDatetime MeetingRetrieveResponseFieldValueType = "DATETIME"`
- `const MeetingRetrieveResponseFieldValueTypeEmail MeetingRetrieveResponseFieldValueType = "EMAIL"`
- `const MeetingRetrieveResponseFieldValueTypeFullName MeetingRetrieveResponseFieldValueType = "FULL_NAME"`
- `const MeetingRetrieveResponseFieldValueTypeMarkdown MeetingRetrieveResponseFieldValueType = "MARKDOWN"`
- `const MeetingRetrieveResponseFieldValueTypeMultiSelect MeetingRetrieveResponseFieldValueType = "MULTI_SELECT"`
- `const MeetingRetrieveResponseFieldValueTypeNumber MeetingRetrieveResponseFieldValueType = "NUMBER"`
- `const MeetingRetrieveResponseFieldValueTypeSingleSelect MeetingRetrieveResponseFieldValueType = "SINGLE_SELECT"`
- `const MeetingRetrieveResponseFieldValueTypeSocialHandle MeetingRetrieveResponseFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingRetrieveResponseFieldValueTypeTelephone MeetingRetrieveResponseFieldValueType = "TELEPHONE"`
- `const MeetingRetrieveResponseFieldValueTypeText MeetingRetrieveResponseFieldValueType = "TEXT"`
- `const MeetingRetrieveResponseFieldValueTypeURL MeetingRetrieveResponseFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType MeetingRetrieveResponseObjectType`
Always `meeting`.
- `const MeetingRetrieveResponseObjectTypeMeeting MeetingRetrieveResponseObjectType = "meeting"`
- `Relationships map[string, MeetingRetrieveResponseRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.
### Meeting Update Response
- `type MeetingUpdateResponse struct{…}`
- `ID string`
Unique identifier for the entity.
- `AccessLevel MeetingUpdateResponseAccessLevel`
The caller's resolved access level for this meeting.
- `const MeetingUpdateResponseAccessLevelFull MeetingUpdateResponseAccessLevel = "FULL"`
- `const MeetingUpdateResponseAccessLevelMetadata MeetingUpdateResponseAccessLevel = "METADATA"`
- `CreatedAt string`
ISO 8601 timestamp of when the entity was created.
- `Fields map[string, MeetingUpdateResponseField]`
Map of field names to their typed values. System fields are prefixed with `$` (e.g. `$name`, `$email`); custom attributes use their bare slug.
- `Value MeetingUpdateResponseFieldValueUnion`
The field value, or null if unset.
- `string`
- `float64`
- `bool`
- `type MeetingUpdateResponseFieldValueArray []string`
- `type MeetingUpdateResponseFieldValueAddress struct{…}`
- `City string`
City name.
- `Country string`
2-letter ISO 3166-1 alpha-2 country code.
- `Latitude float64`
Latitude coordinate.
- `Longitude float64`
Longitude coordinate.
- `PostalCode string`
Postal or ZIP code.
- `State string`
State or province.
- `Street string`
Street address line 1.
- `Street2 string`
Street address line 2.
- `type MeetingUpdateResponseFieldValueFullName struct{…}`
- `FirstName string`
The contact's first name.
- `LastName string`
The contact's last name.
- `ValueType string`
The data type of the field.
- `const MeetingUpdateResponseFieldValueTypeAddress MeetingUpdateResponseFieldValueType = "ADDRESS"`
- `const MeetingUpdateResponseFieldValueTypeCheckbox MeetingUpdateResponseFieldValueType = "CHECKBOX"`
- `const MeetingUpdateResponseFieldValueTypeCurrency MeetingUpdateResponseFieldValueType = "CURRENCY"`
- `const MeetingUpdateResponseFieldValueTypeDatetime MeetingUpdateResponseFieldValueType = "DATETIME"`
- `const MeetingUpdateResponseFieldValueTypeEmail MeetingUpdateResponseFieldValueType = "EMAIL"`
- `const MeetingUpdateResponseFieldValueTypeFullName MeetingUpdateResponseFieldValueType = "FULL_NAME"`
- `const MeetingUpdateResponseFieldValueTypeMarkdown MeetingUpdateResponseFieldValueType = "MARKDOWN"`
- `const MeetingUpdateResponseFieldValueTypeMultiSelect MeetingUpdateResponseFieldValueType = "MULTI_SELECT"`
- `const MeetingUpdateResponseFieldValueTypeNumber MeetingUpdateResponseFieldValueType = "NUMBER"`
- `const MeetingUpdateResponseFieldValueTypeSingleSelect MeetingUpdateResponseFieldValueType = "SINGLE_SELECT"`
- `const MeetingUpdateResponseFieldValueTypeSocialHandle MeetingUpdateResponseFieldValueType = "SOCIAL_HANDLE"`
- `const MeetingUpdateResponseFieldValueTypeTelephone MeetingUpdateResponseFieldValueType = "TELEPHONE"`
- `const MeetingUpdateResponseFieldValueTypeText MeetingUpdateResponseFieldValueType = "TEXT"`
- `const MeetingUpdateResponseFieldValueTypeURL MeetingUpdateResponseFieldValueType = "URL"`
- `HTTPLink string`
URL to view the entity in the Lightfield web app, or null.
- `ObjectType MeetingUpdateResponseObjectType`
Always `meeting`.
- `const MeetingUpdateResponseObjectTypeMeeting MeetingUpdateResponseObjectType = "meeting"`
- `Relationships map[string, MeetingUpdateResponseRelationship]`
Map of relationship names to their associated entities. System relationships are prefixed with `$` (e.g. `$owner`, `$contact`).
- `Cardinality string`
Whether the relationship is `has_one` or `has_many`.
- `ObjectType string`
The type of the related object (e.g. `account`, `contact`).
- `Values []string`
IDs of the related entities.
- `UpdatedAt string`
ISO 8601 timestamp of when the entity was last updated, or null.
- `ExternalID string`
External identifier for the entity, or null if unset.