Invoke Skill Meeting Prep

post/api/v1/skills/meeting.prep/invoke

Produce a pre-meeting briefing for a client meeting — recent topics, open action items, talking points, suggested questions. Read-only; pairs with meeting.followup for the post-meeting half.

Request bodyapplication/json

Field	Type	Description
`client_id`required	`string (uuid)`	—
`meeting_date`required	`string (date)`	—
`meeting_type`	`"initial" \| "quarterly_review" \| "annual" \| "planning" \| "advisory_board" \| "ad_hoc"`	— `initialquarterly_reviewannualplanningadvisory_boardad_hoc`
`attendees`	`string[]`	Optional attendee names — drives addressee-aware talking points.
`agenda_topics`	`string[]`	If provided, focus on these topics rather than scanning broadly.
`lookback_days`	`integer`	Trailing window of comms/topics/workstream activity to summarise.

Responses

200Skill executed successfully

Field Type Description

skillrequired string —

outputrequired

object

—

show nested

Field	Type	Description
`artifact_id`	`string (uuid) \| null`	—
`download_url`	`string`	—
`summary`	`string`	—
`citations`	`any[]`	—
`warnings`	`string[]`	—
`stub_fields`	`string[]`	—
`briefing_text`	`string`	Long-form briefing in markdown — readable version of the artifact.
`talking_points`	`string[]`	—
`recent_topics`	`object[]`	Recent topics surfaced from KB / comms — each entry: {'topic': str, 'last_touched': YYYY-MM-DD}. item shape Empty object.
`open_action_items`	`string[]`	—
`suggested_questions`	`string[]`	—

correlation_idrequired string —

401Authentication required

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

403Insufficient permissions

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

404Skill not found

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

429Rate limit exceeded

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

5XXInternal server error

Field Type Description

errorrequired

object

—

show nested

Field	Type	Description
`type`required	`string`	—
`code`required	`string`	—
`message`required	`string`	—
`param`	`string`	—
`retry_after_seconds`	`integer`	—

curl https://api.dev.arch.ie/api/v1/skills/meeting.prep/invoke \
  -X POST \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
       "client_id": "00000000-0000-0000-0000-000000000000",
       "meeting_date": "string",
       "meeting_type": "initial",
       "attendees": [
         "string"
       ],
       "agenda_topics": [
         "string"
       ],
       "lookback_days": 0
     }'