Sources
List all sources
- Community
- GitHub
- Tutorials
- GETList all endpoints
- POSTCreate an endpoint
- GETRetrieve endpoint
- PUTUpdate an endpoint
- DELDelete endpoint
- PUTRoll endpoint secret
- PUTPause endpoint
- GETList all event deliveries
- POSTBatch retry event delivery
- POSTForce retry event delivery
- GETRetrieve an event delivery
- PUTRetry event delivery
- GETList all events
- POSTCreate an event
- POSTCreate a broadcast event
- POSTBatch replay events
- POSTDynamic Events
- POSTFan out an event
- GETRetrieve an event
- PUTReplay event
- GETList all portal links
- POSTCreate a portal link
- GETRetrieve a portal link
- PUTUpdate a portal link
- PUTRevoke a portal link
Endpoints
Event Deliveries
Events
Portal Links
Sources
List all sources
This endpoint fetches multiple sources
GET
/
v1
/
projects
/
{projectID}
/
sources
Authorization
string
*
Authorization
Required
string
projectID
string
*
projectID
Required
string
Project ID
direction
enum<string>
direction
enum<string>
next_page_cursor
string
next_page_cursor
string
A pagination cursor to fetch the next page of a list
perPage
integer
perPage
integer
The number of items to return per page
prev_page_cursor
string
prev_page_cursor
string
A pagination cursor to fetch the previous page of a list
provider
string
provider
string
The custom source provider e.g. twitter, shopify
sort
string
sort
string
Sort order, values are ASC
or DESC
, defaults to DESC
type
string
type
string
The source type e.g. http, pub_sub
curl --request GET \
--url https://dashboard.getconvoy.io/api/v1/projects/{projectID}/sources \
--header 'Authorization: <api-key>'
{
"message": "<string>",
"status": true,
"data": {
"content": [
{
"created_at": "<string>",
"custom_response": {
"body": "<string>",
"content_type": "<string>"
},
"deleted_at": "<string>",
"forward_headers": [
"<string>"
],
"idempotency_keys": [
"<string>"
],
"is_disabled": true,
"mask_id": "<string>",
"name": "<string>",
"project_id": "<string>",
"provider": "github",
"provider_config": {
"twitter": {
"crc_verified_at": "<string>"
}
},
"pub_sub": {
"amqp": {
"auth": {
"password": "<string>",
"user": "<string>"
},
"bindedExchange": "<string>",
"deadLetterExchange": "<string>",
"host": "<string>",
"port": "<string>",
"queue": "<string>",
"routingKey": "<string>",
"schema": "<string>"
},
"google": {
"project_id": "<string>",
"service_account": [
123
],
"subscription_id": "<string>"
},
"kafka": {
"auth": {
"hash": "<string>",
"password": "<string>",
"tls": true,
"type": "<string>",
"username": "<string>"
},
"brokers": [
"<string>"
],
"consumer_group_id": "<string>",
"topic_name": "<string>"
},
"sqs": {
"access_key_id": "<string>",
"default_region": "<string>",
"queue_name": "<string>",
"secret_key": "<string>"
},
"type": "sqs",
"workers": 123
},
"type": "http",
"uid": "<string>",
"updated_at": "<string>",
"url": "<string>",
"verifier": {
"api_key": {
"header_name": "<string>",
"header_value": "<string>"
},
"basic_auth": {
"password": "<string>",
"username": "<string>"
},
"hmac": {
"encoding": "base64",
"hash": "<string>",
"header": "<string>",
"secret": "<string>"
},
"type": "noop"
}
}
],
"pagination": {
"has_next_page": true,
"has_prev_page": true,
"next_page_cursor": "<string>",
"per_page": 123,
"prev_page_cursor": "<string>"
}
}
}
Authorizations
Authorization
string
headerrequiredPath Parameters
projectID
string
requiredProject ID
Query Parameters
direction
enum<string>
Available options:
next
, prev
next_page_cursor
string
A pagination cursor to fetch the next page of a list
perPage
integer
The number of items to return per page
prev_page_cursor
string
A pagination cursor to fetch the previous page of a list
provider
string
The custom source provider e.g. twitter, shopify
sort
string
Sort order, values are ASC
or DESC
, defaults to DESC
type
string
The source type e.g. http, pub_sub
Response
200 - application/json
message
string
status
boolean
data
object
data.content
object[]
data.content.created_at
string
data.content.custom_response
object
data.content.custom_response.body
string
data.content.custom_response.content_type
string
data.content.deleted_at
string
data.content.forward_headers
string[]
data.content.idempotency_keys
string[]
data.content.is_disabled
boolean
data.content.mask_id
string
data.content.name
string
data.content.project_id
string
data.content.provider
enum<string>
Available options:
github
, twitter
, shopify
data.content.provider_config
object
data.content.provider_config.twitter
object
data.content.provider_config.twitter.crc_verified_at
string
data.content.pub_sub
object
data.content.pub_sub.amqp
object
data.content.pub_sub.amqp.auth
object
data.content.pub_sub.amqp.auth.password
string
data.content.pub_sub.amqp.auth.user
string
data.content.pub_sub.amqp.bindedExchange
string
data.content.pub_sub.amqp.deadLetterExchange
string
data.content.pub_sub.amqp.host
string
data.content.pub_sub.amqp.port
string
data.content.pub_sub.amqp.queue
string
data.content.pub_sub.amqp.routingKey
string
data.content.pub_sub.amqp.schema
string
data.content.pub_sub.google
object
data.content.pub_sub.google.project_id
string
data.content.pub_sub.google.service_account
integer[]
data.content.pub_sub.google.subscription_id
string
data.content.pub_sub.kafka
object
data.content.pub_sub.kafka.auth
object
data.content.pub_sub.kafka.auth.hash
string
data.content.pub_sub.kafka.auth.password
string
data.content.pub_sub.kafka.auth.tls
boolean
data.content.pub_sub.kafka.auth.type
string
data.content.pub_sub.kafka.auth.username
string
data.content.pub_sub.kafka.brokers
string[]
data.content.pub_sub.kafka.consumer_group_id
string
data.content.pub_sub.kafka.topic_name
string
data.content.pub_sub.sqs
object
data.content.pub_sub.sqs.access_key_id
string
data.content.pub_sub.sqs.default_region
string
data.content.pub_sub.sqs.queue_name
string
data.content.pub_sub.sqs.secret_key
string
data.content.pub_sub.type
enum<string>
Available options:
sqs
, google
, kafka
, amqp
data.content.pub_sub.workers
integer
data.content.type
enum<string>
Available options:
http
, rest_api
, pub_sub
, db_change_stream
data.content.uid
string
data.content.updated_at
string
data.content.url
string
data.content.verifier
object
data.content.verifier.api_key
object
data.content.verifier.api_key.header_name
string
data.content.verifier.api_key.header_value
string
data.content.verifier.basic_auth
object
data.content.verifier.basic_auth.password
string
data.content.verifier.basic_auth.username
string
data.content.verifier.hmac
object
data.content.verifier.hmac.encoding
enum<string>
Available options:
base64
, hex
data.content.verifier.hmac.hash
string
data.content.verifier.hmac.header
string
data.content.verifier.hmac.secret
string
data.content.verifier.type
enum<string>
Available options:
noop
, hmac
, basic_auth
, api_key
data.pagination
object
data.pagination.has_next_page
boolean
data.pagination.has_prev_page
boolean
data.pagination.next_page_cursor
string
data.pagination.per_page
integer
data.pagination.prev_page_cursor
string
Was this page helpful?
curl --request GET \
--url https://dashboard.getconvoy.io/api/v1/projects/{projectID}/sources \
--header 'Authorization: <api-key>'
{
"message": "<string>",
"status": true,
"data": {
"content": [
{
"created_at": "<string>",
"custom_response": {
"body": "<string>",
"content_type": "<string>"
},
"deleted_at": "<string>",
"forward_headers": [
"<string>"
],
"idempotency_keys": [
"<string>"
],
"is_disabled": true,
"mask_id": "<string>",
"name": "<string>",
"project_id": "<string>",
"provider": "github",
"provider_config": {
"twitter": {
"crc_verified_at": "<string>"
}
},
"pub_sub": {
"amqp": {
"auth": {
"password": "<string>",
"user": "<string>"
},
"bindedExchange": "<string>",
"deadLetterExchange": "<string>",
"host": "<string>",
"port": "<string>",
"queue": "<string>",
"routingKey": "<string>",
"schema": "<string>"
},
"google": {
"project_id": "<string>",
"service_account": [
123
],
"subscription_id": "<string>"
},
"kafka": {
"auth": {
"hash": "<string>",
"password": "<string>",
"tls": true,
"type": "<string>",
"username": "<string>"
},
"brokers": [
"<string>"
],
"consumer_group_id": "<string>",
"topic_name": "<string>"
},
"sqs": {
"access_key_id": "<string>",
"default_region": "<string>",
"queue_name": "<string>",
"secret_key": "<string>"
},
"type": "sqs",
"workers": 123
},
"type": "http",
"uid": "<string>",
"updated_at": "<string>",
"url": "<string>",
"verifier": {
"api_key": {
"header_name": "<string>",
"header_value": "<string>"
},
"basic_auth": {
"password": "<string>",
"username": "<string>"
},
"hmac": {
"encoding": "base64",
"hash": "<string>",
"header": "<string>",
"secret": "<string>"
},
"type": "noop"
}
}
],
"pagination": {
"has_next_page": true,
"has_prev_page": true,
"next_page_cursor": "<string>",
"per_page": 123,
"prev_page_cursor": "<string>"
}
}
}