# Secoda API API

> Secoda API API on Apizie: 110 endpoints (List Integrations, Create a New Integration, Get Integration by ID, Upload Integration Metadata (via CSV), …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/security:secoda/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `security:secoda`
- Category: Security
- Status: byok
- Source: https://secoda.co
- Page: https://www.apizie.tech/api/security/secoda
- OpenAPI: https://www.apizie.tech/api/security/secoda/openapi.json

Use this API to programmatically use Secoda's data enablement features. With these APIs, you can bring in resource metadata, build documentation pipelines, and manage workspace settings programmatically. To learn more…

## Endpoints

### List Integrations
`GET https://www.apizie.tech/v1/security:secoda/integrations-list-active` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | no | The type of integrations to filter. |

### Create a New Integration
`POST https://www.apizie.tech/v1/security:secoda/integrations-create-new-integration` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get Integration by ID
`GET https://www.apizie.tech/v1/security:secoda/integrations-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | yes | The ID of the integration to retrieve. |

### Upload Integration Metadata (via CSV)
`POST https://www.apizie.tech/v1/security:secoda/integrations-upload-metadata-csv` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | yes | The ID of the integration to upload metadata for. |
| body | object | yes | Form fields as a JSON object |

### Upload Integration Metadata (via JSONL)
`POST https://www.apizie.tech/v1/security:secoda/integrations-upload-jsonl-metadata` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | yes | The ID of the integration to upload metadata and/or lineage for. |
| body | object | yes | Form fields as a JSON object |

### List Databases
`GET https://www.apizie.tech/v1/security:secoda/databases-list-all-active` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | no | The title of the database to search for. |

### Create a New Database
`POST https://www.apizie.tech/v1/security:secoda/databases-create-new-database` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Database by ID
`GET https://www.apizie.tech/v1/security:secoda/databases-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| database_id | string | yes | The unique identifier of the database to retrieve. |

### List Schemas
`GET https://www.apizie.tech/v1/security:secoda/schemas-list-with-filter` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| parent | string | no | The ID of the parent database to filter by. |
| title | string | no | The title of the schema to filter by. |

### Create a New Schema
`POST https://www.apizie.tech/v1/security:secoda/schemas-create-new-schema` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Schema by ID
`GET https://www.apizie.tech/v1/security:secoda/schemas-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| schema_id | string | yes | The ID of the schema to retrieve or update. |

### Update Schema by ID
`POST https://www.apizie.tech/v1/security:secoda/schemas-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| schema_id | string | yes | The ID of the schema to retrieve or update. |
| body | object | yes | JSON request body |

### List Tables
`GET https://www.apizie.tech/v1/security:secoda/tables-list-tables-by-filter` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | no | Integration ID |
| parent_id | string | no | ID of the schema |
| title | string | no | Title of the table |

### Create a New Table
`POST https://www.apizie.tech/v1/security:secoda/tables-create-new-table` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Table by ID
`GET https://www.apizie.tech/v1/security:secoda/tables-get-table-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| table_id | string | yes | ID of the table to retrieve |

### Update Table by ID
`POST https://www.apizie.tech/v1/security:secoda/tables-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| table_id | string | yes | ID of the table to update |
| body | object | no | JSON request body |

### Delete Table by ID
`POST https://www.apizie.tech/v1/security:secoda/tables-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| table_id | string | yes | ID of the table to delete |

### List Columns
`GET https://www.apizie.tech/v1/security:secoda/columns-get-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | no | Optional. Filter columns by integration identifier. |
| parent_id | string | no | Optional. Filter columns by parent identifier. This could be the ID of the table or of the parent column in the case of nested columns. |
| title | string | no | Optional. Filter columns by title of the column. |
| table_title | string | no | Optional. Filter columns by title of the table that the columns belong to. If several integrations have the same naming of tables, it is… |

### Create a New Column
`POST https://www.apizie.tech/v1/security:secoda/columns-create-new-column` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Get Column by ID
`GET https://www.apizie.tech/v1/security:secoda/columns-get-column-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| column_id | string | yes | Identifier of the column to retrieve. |

### Edit Column by ID
`POST https://www.apizie.tech/v1/security:secoda/columns-edit-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| column_id | string | yes | Identifier of the column to retrieve. |
| body | object | no | JSON request body |

### Delete Column by ID
`POST https://www.apizie.tech/v1/security:secoda/columns-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| column_id | string | yes | Identifier of the column to delete. |

### List Dashboard Groups
`GET https://www.apizie.tech/v1/security:secoda/dashboard-groups-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | no | Filter groups by title |

### Create a New Dashboard Group
`POST https://www.apizie.tech/v1/security:secoda/dashboard-groups-create-new-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Dashboard Group by ID
`GET https://www.apizie.tech/v1/security:secoda/dashboard-groups-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| group_id | string | yes | ID of the dashboard group to retrieve |

### List Dashboards
`GET https://www.apizie.tech/v1/security:secoda/dashboards-list-with-filter` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | no | Filter by integration ID |
| parent_id | string | no | Filter by parent ID |
| title | string | no | Filter by title |

### Create a new Dashboard
`POST https://www.apizie.tech/v1/security:secoda/dashboards-create-new-dashboard` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Dashboard by ID
`GET https://www.apizie.tech/v1/security:secoda/dashboards-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dashboard_id | string | yes | The ID of the dashboard to retrieve. |

### Update Dashboard by ID
`POST https://www.apizie.tech/v1/security:secoda/dashboards-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dashboard_id | string | yes | The ID of the dashboard to update. |
| body | object | yes | JSON request body |

### Delete Dashboard by ID
`POST https://www.apizie.tech/v1/security:secoda/dashboards-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| dashboard_id | string | yes | The ID of the dashboard to delete. |

### List Charts
`GET https://www.apizie.tech/v1/security:secoda/charts-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | no | Filter by integration ID |
| parent_id | string | no | Filter by parent ID |
| title | string | no | Filter by title |

### Create a new Chart
`POST https://www.apizie.tech/v1/security:secoda/charts-create-new-chart` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Chart by ID
`GET https://www.apizie.tech/v1/security:secoda/charts-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chart_id | string | yes | The ID of the chart to retrieve. |

### Update Chart by ID
`POST https://www.apizie.tech/v1/security:secoda/charts-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chart_id | string | yes | The ID of the chart to update. |
| body | object | yes | JSON request body |

### Delete Chart by ID
`POST https://www.apizie.tech/v1/security:secoda/charts-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| chart_id | string | yes | The ID of the chart to delete. |

### List Lineage
`GET https://www.apizie.tech/v1/security:secoda/lineage-list-objects-with-filtering` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| from_entity__in | string | no | The source resource. |
| to_entity__in | string | no | The destination resource. |

### Create new Lineage
`POST https://www.apizie.tech/v1/security:secoda/lineage-create-new-lineage-manually` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Lineage by ID
`GET https://www.apizie.tech/v1/security:secoda/lineage-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| lineage_id | string | yes | The ID of the lineage entry to retrieve. |

### Delete Lineage by ID
`POST https://www.apizie.tech/v1/security:secoda/lineage-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| lineage_id | string | yes | The ID of the lineage entry to delete. |

### List Tags
`GET https://www.apizie.tech/v1/security:secoda/tags-list` (byok)

### Create a new Tag
`POST https://www.apizie.tech/v1/security:secoda/tags-create-new-tag` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Tag by ID
`GET https://www.apizie.tech/v1/security:secoda/tags-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tag_id | string | yes | The ID of the tag to retrieve. |

### Update Tag by ID
`POST https://www.apizie.tech/v1/security:secoda/tags-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tag_id | string | yes | The ID of the tag to update. |
| body | object | yes | JSON request body |

### Delete Tag by ID
`POST https://www.apizie.tech/v1/security:secoda/tags-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| tag_id | string | yes | The ID of the tag to delete. |

### List Users
`GET https://www.apizie.tech/v1/security:secoda/users-list` (byok)

### Create a New User
`POST https://www.apizie.tech/v1/security:secoda/users-create-new-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get User by ID
`GET https://www.apizie.tech/v1/security:secoda/users-get-user-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the user to retrieve. |

### Update User by ID
`POST https://www.apizie.tech/v1/security:secoda/users-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the user to update. |
| body | object | yes | JSON request body |

### Delete User by ID
`POST https://www.apizie.tech/v1/security:secoda/users-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the user to delete. |

### List Teams
`GET https://www.apizie.tech/v1/security:secoda/teams-get-list` (byok)

### Create a New Team
`POST https://www.apizie.tech/v1/security:secoda/teams-create-new-team` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Team by ID
`GET https://www.apizie.tech/v1/security:secoda/teams-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the team to retrieve. |

### Update Team by ID
`POST https://www.apizie.tech/v1/security:secoda/teams-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the team to update. |
| body | object | yes | JSON request body |

### Delete Team by ID
`POST https://www.apizie.tech/v1/security:secoda/teams-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the team to delete. |

### List User Groups
`GET https://www.apizie.tech/v1/security:secoda/user-groups-list` (byok)

### Create a New User Group
`POST https://www.apizie.tech/v1/security:secoda/user-groups-create-new-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get User Group by ID
`GET https://www.apizie.tech/v1/security:secoda/user-groups-get-user-group-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the group to retrieve. |

### Update User Group by ID
`POST https://www.apizie.tech/v1/security:secoda/user-groups-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the group to update. |
| body | object | yes | JSON request body |

### Delete User Group by ID
`POST https://www.apizie.tech/v1/security:secoda/user-groups-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the group to delete. |

### List Dictionary Terms
`GET https://www.apizie.tech/v1/security:secoda/terms-get-list-by-title` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | no | Filter terms by title (optional) |

### Create a New Dictionary Term
`POST https://www.apizie.tech/v1/security:secoda/terms-create-new-term` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Dictionary Term by ID
`GET https://www.apizie.tech/v1/security:secoda/terms-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| term_id | string | yes | The unique identifier of the dictionary term |

### Edit Dictionary Term by ID
`POST https://www.apizie.tech/v1/security:secoda/terms-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| term_id | string | yes | The unique identifier of the dictionary term to edit |
| body | object | yes | JSON request body |

### Delete Dictionary Term by ID
`POST https://www.apizie.tech/v1/security:secoda/terms-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| term_id | string | yes | The unique identifier of the dictionary term to delete |

### List Collections
`GET https://www.apizie.tech/v1/security:secoda/collections-list-collections-by-title` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | no | Filter collections by title (optional) |

### Create a New Collection
`POST https://www.apizie.tech/v1/security:secoda/collections-create-new-collection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Collection by ID
`GET https://www.apizie.tech/v1/security:secoda/collections-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| collection_id | string | yes | The unique identifier of the collection |

### Edit Collection by ID
`POST https://www.apizie.tech/v1/security:secoda/collections-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| collection_id | string | yes | The unique identifier of the collection to edit |
| body | object | yes | JSON request body |

### Delete Collection by ID
`POST https://www.apizie.tech/v1/security:secoda/collections-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| collection_id | string | yes | The unique identifier of the collection to delete |

### List Questions
`GET https://www.apizie.tech/v1/security:secoda/questions-get-list` (byok)

### Create a New Question
`POST https://www.apizie.tech/v1/security:secoda/questions-create-new-question` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Question by ID
`GET https://www.apizie.tech/v1/security:secoda/questions-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| question_id | string | yes | The unique identifier of the question |

### Edit Question by ID
`POST https://www.apizie.tech/v1/security:secoda/questions-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| question_id | string | yes | The unique identifier of the question to edit |
| body | object | yes | JSON request body |

### Delete Question by ID
`POST https://www.apizie.tech/v1/security:secoda/questions-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| question_id | string | yes | The unique identifier of the question to delete |

### List Question Replies
`GET https://www.apizie.tech/v1/security:secoda/questions-list-replies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| question_id | string | no | Filter replies by question_id (optional) |

### Create a New Question Reply
`POST https://www.apizie.tech/v1/security:secoda/questions-create-new-reply` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Question Reply by ID
`GET https://www.apizie.tech/v1/security:secoda/questions-get-reply-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reply_id | string | yes | The unique identifier of the reply |

### Edit Question Reply by ID
`POST https://www.apizie.tech/v1/security:secoda/questions-edit-reply-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reply_id | string | yes | The unique identifier of the reply to edit |
| body | object | yes | JSON request body |

### Delete Question Reply by ID
`POST https://www.apizie.tech/v1/security:secoda/questions-delete-reply-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reply_id | string | yes | The unique identifier of the reply to delete |

### List Documents
`GET https://www.apizie.tech/v1/security:secoda/documents-list-documents-by-title` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | no | Filter documents by title (optional) |

### Create a New Document
`POST https://www.apizie.tech/v1/security:secoda/documents-create-new-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Document by ID
`GET https://www.apizie.tech/v1/security:secoda/documents-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| document_id | string | yes | The unique identifier of the document |

### Edit Document by ID
`POST https://www.apizie.tech/v1/security:secoda/documents-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| document_id | string | yes | The unique identifier of the document to edit |
| body | object | yes | JSON request body |

### Delete Document by ID
`POST https://www.apizie.tech/v1/security:secoda/documents-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| document_id | string | yes | The unique identifier of the document to delete |

### List Queries
`GET https://www.apizie.tech/v1/security:secoda/queries-get-list` (byok)

### Get Query by ID
`GET https://www.apizie.tech/v1/security:secoda/queries-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query_id | string | yes | The unique identifier of the query |

### List Monitors
`GET https://www.apizie.tech/v1/security:secoda/monitors-list-monitors` (byok)

### Get Monitor by ID
`GET https://www.apizie.tech/v1/security:secoda/monitors-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| monitor_id | string | yes | The unique identifier of the monitor |

### List Incidents
`GET https://www.apizie.tech/v1/security:secoda/monitors-list-incidents` (byok)

### Get Incident by ID
`GET https://www.apizie.tech/v1/security:secoda/monitors-get-incident-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| incident_id | string | yes | The unique identifier of the incident |

### List Measurements
`GET https://www.apizie.tech/v1/security:secoda/monitors-list-measurements` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| monitor | string | no | The unique identifier of the monitor |
| incident_id | string | no | The unique identifier of the incident |

### List Event Categories
`GET https://www.apizie.tech/v1/security:secoda/event-categories-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| title | string | no | Filter event categories by title |

### Create a New Event Category
`POST https://www.apizie.tech/v1/security:secoda/event-categories-create-new-category` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Event Category by Id
`GET https://www.apizie.tech/v1/security:secoda/event-categories-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_category_id | string | yes | ID of the event category to retrieve |

### List Events
`GET https://www.apizie.tech/v1/security:secoda/events-list-events-by-filtering` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | no | Filter by integration ID |
| parent_id | string | no | Filter by parent ID |
| title | string | no | Filter by title |

### Create a new Event
`POST https://www.apizie.tech/v1/security:secoda/events-create-new-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Event by ID
`GET https://www.apizie.tech/v1/security:secoda/events-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_id | string | yes | The ID of the event to retrieve. |

### Update an Event by ID
`POST https://www.apizie.tech/v1/security:secoda/events-update-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_id | string | yes | The ID of the event to update. |
| body | object | yes | JSON request body |

### Delete Event by ID
`POST https://www.apizie.tech/v1/security:secoda/events-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_id | string | yes | The ID of the event to delete. |

### List Event Properties
`GET https://www.apizie.tech/v1/security:secoda/event-properties-list-event-properties` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| integration_id | string | no | Filter by integration ID |
| parent_id | string | no | Filter by parent ID |
| title | string | no | Filter by title |

### Create a new Event Property
`POST https://www.apizie.tech/v1/security:secoda/event-properties-create-new-property` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Event Property by ID
`GET https://www.apizie.tech/v1/security:secoda/event-properties-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_property_id | string | yes | The ID of the event property to retrieve. |

### Update an Event Property by ID
`POST https://www.apizie.tech/v1/security:secoda/event-properties-update-by-identifier` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_property_id | string | yes | The ID of the event property to update. |
| body | object | yes | JSON request body |

### Delete Event Property by ID
`POST https://www.apizie.tech/v1/security:secoda/event-properties-delete-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| event_property_id | string | yes | The ID of the event property to delete. |

### List Metrics
`GET https://www.apizie.tech/v1/security:secoda/metrics-list` (byok)

### Create a new Metric
`POST https://www.apizie.tech/v1/security:secoda/metrics-create-new-metric` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Get Metric by ID
`GET https://www.apizie.tech/v1/security:secoda/metrics-get-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| metric_id | string | yes |  |

### Update a metric
`POST https://www.apizie.tech/v1/security:secoda/metrics-update-metric-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| metric_id | string | yes |  |
| body | object | yes | JSON request body |

### Delete a metric
`POST https://www.apizie.tech/v1/security:secoda/metrics-delete-metric-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| metric_id | string | yes |  |

### Run a Metric
`POST https://www.apizie.tech/v1/security:secoda/metrics-run-metric-execution` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| metric_id | string | yes |  |
| body | object | yes | JSON request body |

## Example
```
curl "https://www.apizie.tech/v1/security:secoda/integrations-list-active" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Secoda API API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/security:secoda/integrations-list-active with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Secoda API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Secoda API itself also needs your own key from api.secoda.co.

### Can AI agents use the Secoda API API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key security:secoda.

### What is the status of the Secoda API API?
Needs your own provider key (bring your own key)