LogoLogo
  • Introduction
    • Welcome
    • Quickstart
  • Platform
    • Connections
      • Jobs
      • Sync types
      • Sync schedule
      • Column Anonymization
      • Block Window
    • Connect to databases
    • Running jobs manually
    • Alert Integrations
      • Discord
      • Email
      • Slack
    • Runs history
    • How we move data
  • Connectors
    • APIs
      • ActiveCampaign
      • Amplitude
      • Asaas
      • Asana
      • Bling
      • Beehiiv
      • BomControle
      • Campaign Monitor
      • ClickUp
      • Conta Azul
      • Convenia
      • CustomerX
      • Delighted
      • Facebook Ads
      • FreshChat
      • Freshdesk
      • Gainsight
      • Google Ads
      • Hotmart
      • HubSpot
      • Intercom
      • Jira
      • Linkedin Ads
      • MailChimp
      • MailGun
      • Mixpanel
      • Monday
      • Movidesk
      • Omie
      • Pipefy
      • Qulture.Rocks
      • RD Station CRM
      • RD Station Marketing
      • Sankhya
      • Sentry
      • Stripe
      • Superlógica
      • Tiny
      • Teamwork Desk
      • Track.co
      • Twitch.tv
      • Twygo
      • Typeform
      • Vindi
      • Zendesk
    • Databases
      • Firebird
      • MySQL
      • Neo4j
      • Oracle
      • PostgreSQL
  • Destinations
    • BigQuery
      • Hosted by Erathos
    • Databricks
    • PostgreSQL
      • Aws (RDS)
      • Azure
    • Redshift
    • S3 Iceberg
  • API
    • Introduction
      • Trigger jobs outside Erathos
      • Trigger jobs in Erathos
    • Quickstart
      • Airflow
      • Dbt Cloud
      • Erathos
      • Prefect
    • Concepts
      • Authentication
      • Metadata
      • Rules
      • Variables and secrets
    • API Reference
      • Jobs
      • Orchestration
      • Secrets
      • Variables
      • Workspaces
  • Settings
    • User settings
    • Workspace settings
Powered by GitBook
On this page
  1. API
  2. API Reference

Orchestration

PreviousJobsNextSecrets

Last updated 5 months ago

Retrieve orchestration webhook

get
Authorizations
Path parameters
_idstring · uuidRequired
workspace_idstring · uuidRequired
Responses
200Success
application/json
get
GET /developers/workspaces/{workspace_id}/orchestration/webhooks/{_id}/ HTTP/1.1
Host: api.erathos.com
Authorization: YOUR_API_KEY
Accept: */*
200Success
{
  "_id": "123e4567-e89b-12d3-a456-426614174000",
  "_created_at": "2025-05-19T05:05:16.413Z",
  "_updated_at": "2025-05-19T05:05:16.413Z",
  "description": "text",
  "is_active": true,
  "method": "DELETE",
  "url": "https://example.com",
  "header": null,
  "body": null,
  "rules": [
    {
      "variable_name": "JOB_ID",
      "operation": "EQUAL",
      "value": "text"
    }
  ],
  "jobs": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

Delete orchestration webhook

delete
Authorizations
Path parameters
_idstring · uuidRequired
workspace_idstring · uuidRequired
Responses
204
No response body
delete
DELETE /developers/workspaces/{workspace_id}/orchestration/webhooks/{_id}/ HTTP/1.1
Host: api.erathos.com
Authorization: YOUR_API_KEY
Accept: */*
204

No response body

No content

  • GETList orchestration webhooks
  • POSTCreate orchestration webhook
  • GETRetrieve orchestration webhook
  • PUTEdit orchestration webhook
  • DELETEDelete orchestration webhook

List orchestration webhooks

get
Authorizations
Path parameters
workspace_idstring · uuidRequired
Query parameters
descriptionanyOptional
is_activebooleanOptional
jobanyOptional

Filter by job id

methodanyOptional
orderingstringOptional

Which field to use when ordering the results.

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

urlanyOptional
Responses
200Success
application/json
get
GET /developers/workspaces/{workspace_id}/orchestration/webhooks/ HTTP/1.1
Host: api.erathos.com
Authorization: YOUR_API_KEY
Accept: */*
200Success
{
  "count": 50,
  "next_page": 3,
  "previous_page": 1,
  "page_size": 10,
  "total_pages": 5,
  "current_page": 2,
  "results": [
    {
      "_id": "123e4567-e89b-12d3-a456-426614174000",
      "_created_at": "2025-05-19T05:05:16.413Z",
      "_updated_at": "2025-05-19T05:05:16.413Z",
      "description": "text",
      "is_active": true
    }
  ]
}

Create orchestration webhook

post
Authorizations
Path parameters
workspace_idstring · uuidRequired
Body

A ModelSerializer that takes an additional fields argument that controls which fields should be displayed.

_idstring · uuidRead-onlyRequired
_created_atstring · date-timeRead-onlyRequired
_updated_atstring · date-timeRead-onlyRequired
descriptionstring · max: 255Required
is_activebooleanRequired
methodstring · enumRequired
  • DELETE - DELETE
  • GET - GET
  • PATCH - PATCH
  • POST - POST
  • PUT - PUT
Possible values:
urlstring · uri · max: 1000Required
headerany | nullableOptional
bodyany | nullableOptional
jobsstring · uuid[]Required
Responses
201Success
application/json
post
POST /developers/workspaces/{workspace_id}/orchestration/webhooks/ HTTP/1.1
Host: api.erathos.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 231

{
  "description": "text",
  "is_active": true,
  "method": "DELETE",
  "url": "https://example.com",
  "header": null,
  "body": null,
  "rules": [
    {
      "variable_name": "JOB_ID",
      "operation": "EQUAL",
      "value": "text"
    }
  ],
  "jobs": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}
201Success
{
  "_id": "123e4567-e89b-12d3-a456-426614174000",
  "_created_at": "2025-05-19T05:05:16.413Z",
  "_updated_at": "2025-05-19T05:05:16.413Z",
  "description": "text",
  "is_active": true,
  "method": "DELETE",
  "url": "https://example.com",
  "header": null,
  "body": null,
  "rules": [
    {
      "variable_name": "JOB_ID",
      "operation": "EQUAL",
      "value": "text"
    }
  ],
  "jobs": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

Edit orchestration webhook

put
Authorizations
Path parameters
_idstring · uuidRequired
workspace_idstring · uuidRequired
Body

A ModelSerializer that takes an additional fields argument that controls which fields should be displayed.

_idstring · uuidRead-onlyRequired
_created_atstring · date-timeRead-onlyRequired
_updated_atstring · date-timeRead-onlyRequired
descriptionstring · max: 255Required
is_activebooleanRequired
methodstring · enumRequired
  • DELETE - DELETE
  • GET - GET
  • PATCH - PATCH
  • POST - POST
  • PUT - PUT
Possible values:
urlstring · uri · max: 1000Required
headerany | nullableOptional
bodyany | nullableOptional
jobsstring · uuid[]Required
Responses
200Success
application/json
put
PUT /developers/workspaces/{workspace_id}/orchestration/webhooks/{_id}/ HTTP/1.1
Host: api.erathos.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 231

{
  "description": "text",
  "is_active": true,
  "method": "DELETE",
  "url": "https://example.com",
  "header": null,
  "body": null,
  "rules": [
    {
      "variable_name": "JOB_ID",
      "operation": "EQUAL",
      "value": "text"
    }
  ],
  "jobs": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}
200Success
{
  "_id": "123e4567-e89b-12d3-a456-426614174000",
  "_created_at": "2025-05-19T05:05:16.413Z",
  "_updated_at": "2025-05-19T05:05:16.413Z",
  "description": "text",
  "is_active": true,
  "method": "DELETE",
  "url": "https://example.com",
  "header": null,
  "body": null,
  "rules": [
    {
      "variable_name": "JOB_ID",
      "operation": "EQUAL",
      "value": "text"
    }
  ],
  "jobs": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}