# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Relevance AI Endpoints Services API version: 1.0.0 extends: openapi/relevance-ai-services-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 10 - target: $.paths['/slack/interactions'].post update: x-apievangelist-phrasing: intent: Receive Slack approval interactions effect: write questions: - How are agent approvals clicked in Slack sent back to the platform? - Which endpoint receives Slack block kit button actions for approving or rejecting an agent? instructions: - text: 'Forward this Slack interaction payload for agent approval: {payload}.' slots: payload: requestBody.payload - text: Submit the Slack block kit rejection payload {payload}. slots: payload: requestBody.payload method: generated generated: '2026-09-26' - target: $.paths['/organizations/{organization_id}/delivery_external_id'].get update: x-apievangelist-phrasing: intent: Get the AWS delivery external ID for an org effect: read questions: - What external ID do I put in my AWS IAM trust policy for cross-account delivery? - Can I get or create my organization's delivery external ID for AssumeRole? instructions: - text: Get the delivery external ID for organization {organization_id}. slots: organization_id: path.organization_id - text: Give me the AssumeRole external ID for organization {organization_id}. slots: organization_id: path.organization_id method: generated generated: '2026-09-26' - target: $.paths['/google-calendar/events'].get update: x-apievangelist-phrasing: intent: List Google Calendar events in a time range effect: read questions: - What's on my connected Google Calendar this week? - Can I list events from a specific Google calendar ID? instructions: - text: List Google Calendar events from {start_datetime} to {end_datetime}. slots: start_datetime: query.start_datetime end_datetime: query.end_datetime - text: Show events on calendar {calendar_id} using account {oauth_account_id}. slots: calendar_id: query.calendar_id oauth_account_id: query.oauth_account_id method: generated generated: '2026-09-26' - target: $.paths['/config-flags'].get update: x-apievangelist-phrasing: intent: Get all config flags for the app effect: read questions: - Which feature flags are enabled for my signed-in app? - Does the config flags response include a hash for caching? instructions: - text: Get all config flags for my authenticated app. - text: Fetch the full feature flag set with its content hash. method: generated generated: '2026-09-26' - target: $.paths['/config-flags/public'].get update: x-apievangelist-phrasing: intent: Get public config flags without signing in effect: read questions: - Which config flags can be read before a user logs in? - Is there an unauthenticated way to fetch public feature flags? instructions: - text: Get the public config flags for the login page. - text: Fetch only public-namespace flags without auth. method: generated generated: '2026-09-26' - target: $.paths['/s/{short_url_key}'].get update: x-apievangelist-phrasing: intent: Resolve a short URL effect: read questions: - Where does a Relevance AI short link point to? - Can I follow a short URL key to its original address? instructions: - text: Resolve short URL {short_url_key}. slots: short_url_key: path.short_url_key - text: Follow the short link {short_url_key} to its original URL. slots: short_url_key: path.short_url_key method: generated generated: '2026-09-26' - target: $.paths['/datasets/{dataset_id}/get_file_upload_urls'].post update: x-apievangelist-phrasing: intent: Get upload URLs for files in a dataset effect: write questions: - How do I upload files into a dataset? - Are files uploaded to a dataset deleted when the dataset is deleted? instructions: - text: Get upload URLs for files {files} in dataset {dataset_id}. slots: files: requestBody.files dataset_id: path.dataset_id - text: Create upload links in dataset {dataset_id} for {files}, keeping the file path in the URL. slots: dataset_id: path.dataset_id files: requestBody.files method: generated generated: '2026-09-26' - target: $.paths['/services/get_temporary_public_file_upload_url'].post update: x-apievangelist-phrasing: intent: Get a public one-hour file upload URL effect: write questions: - Can someone without an account upload a file temporarily? - How long does a public temporary upload last? instructions: - text: Give anyone, even without an account, a public upload URL for a {extension} file. slots: extension: requestBody.extension - text: Create an unauthenticated one-hour upload link. method: generated generated: '2026-09-26' - target: $.paths['/services/get_temporary_file_upload_url'].post update: x-apievangelist-phrasing: intent: Get a temporary file upload URL effect: write questions: - Where do I get a temporary upload URL for a file as a signed-in user? - Can I set the file name when requesting a temporary upload link? instructions: - text: Get a temporary upload URL for file {filename}. slots: filename: requestBody.filename - text: As a signed-in user, get a temporary upload URL for {filename} with extension {extension}. slots: extension: requestBody.extension filename: requestBody.filename method: generated generated: '2026-09-26' - target: $.paths['/bugs/submit'].post update: x-apievangelist-phrasing: intent: Submit a bug report effect: write questions: - How do I report a bug I found in the app? - What details are required when submitting a bug report? instructions: - text: 'Submit a {category} bug report for project {project} in region {region}: {message}.' slots: category: requestBody.category project: requestBody.project region: requestBody.region message: requestBody.message - text: File a bug from source {source} saying {message} for project {project}, category {category}, region {region}. slots: source: requestBody.source message: requestBody.message project: requestBody.project category: requestBody.category region: requestBody.region method: generated generated: '2026-09-26'