PUT
/
api
/
v1
/
public
/
provider-integrations
/
{providerId}
{
  "providerCode": "SLACK",
  "name": "SkydaSlack7",
  "configuration": {
    "botAuthToken": "DFF",
    "appId": "DFDF"
  }
}
{
  "id": "a8f39791-60ec-45a6-beb9-ead8f8d859af",
  "providerCode": "SLACK",
  "name": "SkydaSlack7",
  "status": "ACTIVE",
  "configuration": {
    "botAuthToken": "DFF",
    "appId": "DFDF"
  },
  "createdAt": "2025-07-29T12:00:00Z",
  "updatedAt": "2025-07-29T12:30:00Z"
}
Authorization
string
required
Bearer token for API authentication. Format: Bearer {{apiToken}}
Content-Type
string
required
Must be set to application/json

Path Parameters

providerId
string
required
Unique identifier of the provider integration to update

Request Body

providerCode
string
required
Code of the provider (e.g., “SLACK”, “SENDGRID”)
name
string
required
New display name for the provider integration
configuration
object
required
Updated provider-specific configuration object

Configuration Parameters for Slack

configuration.botAuthToken
string
required
Updated Bot User OAuth Token from Slack
configuration.appId
string
required
Updated App ID from Slack

Request Example

{
  "providerCode": "SLACK",
  "name": "SkydaSlack7",
  "configuration": {
    "botAuthToken": "DFF",
    "appId": "DFDF"
  }
}

Response

{
  "id": "a8f39791-60ec-45a6-beb9-ead8f8d859af",
  "providerCode": "SLACK",
  "name": "SkydaSlack7",
  "status": "ACTIVE",
  "configuration": {
    "botAuthToken": "DFF",
    "appId": "DFDF"
  },
  "createdAt": "2025-07-29T12:00:00Z",
  "updatedAt": "2025-07-29T12:30:00Z"
}

Status Codes

200 - OK: Provider integration updated successfully
400 - Bad Request: Invalid input data
401 - Unauthorized: Invalid or missing authentication
404 - Not Found: Provider integration not found
409 - Conflict: Provider integration with this name already exists
500 - Internal Server Error: Failed to update provider integration

cURL Example

curl --location --request PUT 'https://api.trysiren.io/api/v1/public/provider-integrations/a8f39791-60ec-45a6-beb9-ead8f8d859af' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bd9d07a8073a41eca003e5f0a841db7c' \
--data '{
  "providerCode": "SLACK",
  "name": "SkydaSlack7",
  "configuration": {
    "botAuthToken": "DFF",
    "appId": "DFDF"
  }
}'