Sources
Retrieve a source
- 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
Retrieve a source
This endpoint retrieves a source by its id
GET
/
v1
/
projects
/
{projectID}
/
sources
/
{sourceID}
Authorization
string
*
Authorization
Required
string
projectID
string
*
projectID
Required
string
Project ID
sourceID
string
*
sourceID
Required
string
Source ID
curl --request GET \
--url https://dashboard.getconvoy.io/api/v1/projects/{projectID}/sources/{sourceID} \
--header 'Authorization: <api-key>'
{
"message": "<string>",
"status": true,
"data": {
"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"
}
}
}
Authorizations
Authorization
string
headerrequiredPath Parameters
projectID
string
requiredProject ID
sourceID
string
requiredSource ID
Response
200 - application/json
message
string
status
boolean
data
object
data.created_at
string
data.custom_response
object
data.custom_response.body
string
data.custom_response.content_type
string
data.deleted_at
string
data.forward_headers
string[]
data.idempotency_keys
string[]
data.is_disabled
boolean
data.mask_id
string
data.name
string
data.project_id
string
data.provider
enum<string>
Available options:
github
, twitter
, shopify
data.provider_config
object
data.provider_config.twitter
object
data.provider_config.twitter.crc_verified_at
string
data.pub_sub
object
data.pub_sub.amqp
object
data.pub_sub.amqp.auth
object
data.pub_sub.amqp.auth.password
string
data.pub_sub.amqp.auth.user
string
data.pub_sub.amqp.bindedExchange
string
data.pub_sub.amqp.deadLetterExchange
string
data.pub_sub.amqp.host
string
data.pub_sub.amqp.port
string
data.pub_sub.amqp.queue
string
data.pub_sub.amqp.routingKey
string
data.pub_sub.amqp.schema
string
data.pub_sub.google
object
data.pub_sub.google.project_id
string
data.pub_sub.google.service_account
integer[]
data.pub_sub.google.subscription_id
string
data.pub_sub.kafka
object
data.pub_sub.kafka.auth
object
data.pub_sub.kafka.auth.hash
string
data.pub_sub.kafka.auth.password
string
data.pub_sub.kafka.auth.tls
boolean
data.pub_sub.kafka.auth.type
string
data.pub_sub.kafka.auth.username
string
data.pub_sub.kafka.brokers
string[]
data.pub_sub.kafka.consumer_group_id
string
data.pub_sub.kafka.topic_name
string
data.pub_sub.sqs
object
data.pub_sub.sqs.access_key_id
string
data.pub_sub.sqs.default_region
string
data.pub_sub.sqs.queue_name
string
data.pub_sub.sqs.secret_key
string
data.pub_sub.type
enum<string>
Available options:
sqs
, google
, kafka
, amqp
data.pub_sub.workers
integer
data.type
enum<string>
Available options:
http
, rest_api
, pub_sub
, db_change_stream
data.uid
string
data.updated_at
string
data.url
string
data.verifier
object
data.verifier.api_key
object
data.verifier.api_key.header_name
string
data.verifier.api_key.header_value
string
data.verifier.basic_auth
object
data.verifier.basic_auth.password
string
data.verifier.basic_auth.username
string
data.verifier.hmac
object
data.verifier.hmac.encoding
enum<string>
Available options:
base64
, hex
data.verifier.hmac.hash
string
data.verifier.hmac.header
string
data.verifier.hmac.secret
string
data.verifier.type
enum<string>
Available options:
noop
, hmac
, basic_auth
, api_key
Was this page helpful?
curl --request GET \
--url https://dashboard.getconvoy.io/api/v1/projects/{projectID}/sources/{sourceID} \
--header 'Authorization: <api-key>'
{
"message": "<string>",
"status": true,
"data": {
"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"
}
}
}