---
title: "Add an allowlisted typed read action to an Integration"
method: POST
path: "/v1/integrations/{integration_id}/actions"
---

# Add an allowlisted typed read action to an Integration

`POST /v1/integrations/{integration_id}/actions`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/integrations/{integration_id}/actions`
- Auth: none declared

V1 accepts read-only actions only. Mutation actions remain unavailable until Skysay provides a server-owned caller-confirmation flow.

## Path parameters

- `integration_id` string, required

## Request body

- object
  - `input_schema` object, required
  - `name` string, required
  - `operation_kind` 'read'
  - `organization_id` string, required
  - `output_schema` object, required
  - `project_id` string, required
  - `requires_confirmation` false
  - `timeout_seconds` integer

## Response `201`

Integration action metadata

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/148c7e111260?raw)