Productmind API

Internal meetings

Internal meetings are your team's own meetings, such as debriefs, roadmap discussions and retros. Log a meeting with its agenda and notes, have an AI notetaker join the call or dismiss it, and get an AI summary with decisions and action points. Link a meeting to the features, feature requests and tasks it was about. See Internal meetings.


List internal meetings in a workspace

GET
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings

Returns internal meetings — a PM/engineer debrief, a roadmap discussion, a retro. A DIFFERENT entity from customer interactions: it carries no contact and no customer research, and never appears in the customer-interaction list. Supports filtering by status, tags, source and participant email.

List internal meetings in a workspace › path Parameters

workspaceId
​string · required

Workspace UUID

List internal meetings in a workspace › query Parameters

page
​number

Page number (1-indexed, default 1)

limit
​number

Items per page (default 50)

sortBy
​string · enum

Field to sort by

Enum values:
createdAt
updatedAt
status
title
scheduledAt
source
date
creator
sortOrder
​string · enum

Sort direction (default desc)

Enum values:
asc
desc
search
​string

Full-text search across searchable fields

status
​string · enum

Filter by meeting status

Enum values:
draft
scheduled
in_progress
processing
completed
cancelled
failed
searchText
​string

Free-text search over title, agenda and notes

tags
​string

Comma-separated tag names to filter by

sources
​string

Comma-separated meeting sources to filter by. Use productmind for meetings created in Productmind rather than imported.

participantEmails
​string

Comma-separated participant email addresses to filter by

List internal meetings in a workspace › Responses

200

List of internal meetings

​InternalMeetingDTO[] · required
​object
​object

Create an internal meeting

POST
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings

Log an internal meeting. Supply notes to have it summarized straight away, or scheduledAt + meetingUrl + recordingEnabled to send the Recall notetaker. Recall minutes count against the same assisted-minutes quota a customer meeting draws on.

Create an internal meeting › path Parameters

workspaceId
​string · required

Workspace UUID

Create an internal meeting › Request Body

title
​string · minLength: 1 · maxLength: 500 · required

What the meeting is about — a real column here, unlike CustomerInteraction where the name hides inside the summary blob.

agenda
​string

What the meeting intends to cover. Fed to the summarizer as steering context, so it shapes the summary as well as the invitation.

notes
​string

Meeting notes, pasted. The Recall notetaker writes a transcript into this same field.

tags
​string[]
scheduledAt
​string
endsAt
​string

When the meeting ends. Only meaningful paired with scheduledAt, and must be strictly after it. Leave it out when the duration is unknown — the UI renders an unset end as one hour.

meetingUrl
​string

Google Meet / Zoom / Teams link the notetaker joins.

recordingEnabled
​boolean

Send the Recall notetaker to this meeting.

transcriptionEnabled
​boolean
​object[] · maxItems: 100

People on the meeting invitation. The server normalizes these into participants and resolves platform users among them; blank or malformed addresses are dropped rather than rejected.

externalSource
​string · enum

Which external system this meeting was imported from.

Enum values:
google_calendar
externalId
​string · minLength: 1 · maxLength: 255

The external system's own id for this event — half of the dedup key.

externalSourceUrl
​string · uri

Deep link back to the event in the external system.

Create an internal meeting › Responses

Created meeting

​InternalMeetingDTO · required

Get an internal meeting by ID

GET
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}

Retrieve a single internal meeting with its agenda, notes, participants and summary.

Get an internal meeting by ID › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

Get an internal meeting by ID › Responses

200

Meeting details

​InternalMeetingDTO · required

Update an internal meeting

PUT
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}

Modify a meeting's details. summary is MERGED rather than replaced, which is what lets the UI edit one action point — retype it, re-pick its assignee, tick it done — without clobbering the AI's narrative text.

Update an internal meeting › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

Update an internal meeting › Request Body

title
​string · minLength: 1 · maxLength: 500
agenda
​string
notes
​string
tags
​string[]
​
​
meetingUrl
​string
recordingEnabled
​boolean
transcriptionEnabled
​boolean
​object
​object[] · maxItems: 100

The meeting's whole participant roster, replaced. The server normalizes the addresses, resolves platform users among them, keeps the role it already recorded for anyone already on the roster, and drops blank or malformed entries. Send an empty array to clear it.

Update an internal meeting › Responses

200

Updated meeting

​InternalMeetingDTO · required

Delete an internal meeting

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}

Permanently remove an internal meeting, its tags and its links.

Delete an internal meeting › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

Delete an internal meeting › Responses

200

Meeting deleted

No data returned

Update an internal meeting's status

PUT
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}/status

Change the status of an internal meeting (e.g. scheduled → completed).

Update an internal meeting's status › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

Update an internal meeting's status › Request Body

status
​string · enum · required
Enum values:
draft
scheduled
in_progress
processing
completed
cancelled
failed

Update an internal meeting's status › Responses

200

Updated meeting

​InternalMeetingDTO · required

Summarize an internal meeting

POST
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}/summarize

Queue AI summarization of a meeting's notes. Returns as soon as the job is published; the result — a summary with assignable action points — arrives over the internal-meeting:status:updated socket frame.

Summarize an internal meeting › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

Summarize an internal meeting › Responses

200

Summarization queued

No data returned

Dismiss the notetaker from an internal meeting

POST
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}/cancel-recording

Cancel the scheduled Recall bot and turn recording off.

Dismiss the notetaker from an internal meeting › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

Dismiss the notetaker from an internal meeting › Responses

200

Recording cancelled

No data returned

List the features, requests and tasks a meeting is linked to

GET
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}/relationships

Returns the meeting's related_to links, hydrated with each target's display id and title.

List the features, requests and tasks a meeting is linked to › path Parameters

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

List the features, requests and tasks a meeting is linked to › Responses

200

Linked entities


POST
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}/relationships

Create a related_to link from this meeting. A meeting is only ever the SOURCE of such a link — nothing is related INTO a meeting.

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

targetType
​string · required

feature, feature_request or task.

targetId
​string · required

UUID of the entity to link.

The created link

​InternalMeetingRelationshipDTO · required

DELETE
https://api.productmind.ai
/workspaces/{workspaceId}/internal-meetings/{id}/relationships/{relationshipId}

Remove a related_to link. The link must belong to the meeting in the path.

workspaceId
​string · required

Workspace UUID

id
​string · required

Internal meeting UUID

relationshipId
​string · required

Relationship UUID

200

Link removed

No data returned