Revision
Hydrate a revision
Authentication
WRITE API
- Write
READ API
- Read
PLATFORM API
- OAuth
- Project
- Provider App
- Integration
- Revision
- Installation
- Objects & Fields
- Operation
- Provider
- API Key
- Connection
- Group
- Consumer
- Destination
- Upload URL
- Org
- User
- Billing Account
Revision
Hydrate a revision
Hydrate a revision with information from the consumer’s SaaS instance.
GET
/
projects
/
{projectIdOrName}
/
integrations
/
{integrationId}
/
revisions
/
{revisionId}
:hydrate
curl --request GET \
--url https://api.withampersand.com/v1/projects/{projectIdOrName}/integrations/{integrationId}/revisions/{revisionId}:hydrate \
--header 'X-Api-Key: <api-key>'
{
"id": "revision-id-1",
"specVersion": "1.0.0",
"createTime": "2023-11-07T05:31:56Z",
"content": {
"name": "<string>",
"displayName": "<string>",
"provider": "<string>",
"read": {
"objects": [
{
"error": "Failed to fetch fields from provider",
"objectName": "<string>",
"displayName": "<string>",
"mapToName": "people",
"mapToDisplayName": "People",
"destination": "<string>",
"schedule": "<string>",
"requiredFields": [
{
"fieldName": "<string>",
"displayName": "<string>",
"mapToName": "account_id",
"mapToDisplayName": "Account ID"
}
],
"optionalFields": [
{
"fieldName": "<string>",
"displayName": "<string>",
"mapToName": "account_id",
"mapToDisplayName": "Account ID"
}
],
"optionalFieldsAuto": "all",
"allFields": [
{
"fieldName": "<string>",
"displayName": "<string>",
"mapToName": "account_id",
"mapToDisplayName": "Account ID"
}
],
"allFieldsMetadata": {},
"backfill": {
"defaultPeriod": {
"days": 30,
"fullHistory": false
}
}
}
]
},
"write": {
"objects": [
{
"objectName": "<string>",
"displayName": "<string>",
"valueDefaults": {
"allowAnyFields": true
}
}
]
},
"proxy": {
"enabled": true
}
}
}
Authorizations
Path Parameters
The Ampersand project ID or project name.
The integration ID.
The revision ID.
Query Parameters
The connection ID.
Response
200
application/json
Hydrated revision
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://api.withampersand.com/v1/projects/{projectIdOrName}/integrations/{integrationId}/revisions/{revisionId}:hydrate \
--header 'X-Api-Key: <api-key>'
{
"id": "revision-id-1",
"specVersion": "1.0.0",
"createTime": "2023-11-07T05:31:56Z",
"content": {
"name": "<string>",
"displayName": "<string>",
"provider": "<string>",
"read": {
"objects": [
{
"error": "Failed to fetch fields from provider",
"objectName": "<string>",
"displayName": "<string>",
"mapToName": "people",
"mapToDisplayName": "People",
"destination": "<string>",
"schedule": "<string>",
"requiredFields": [
{
"fieldName": "<string>",
"displayName": "<string>",
"mapToName": "account_id",
"mapToDisplayName": "Account ID"
}
],
"optionalFields": [
{
"fieldName": "<string>",
"displayName": "<string>",
"mapToName": "account_id",
"mapToDisplayName": "Account ID"
}
],
"optionalFieldsAuto": "all",
"allFields": [
{
"fieldName": "<string>",
"displayName": "<string>",
"mapToName": "account_id",
"mapToDisplayName": "Account ID"
}
],
"allFieldsMetadata": {},
"backfill": {
"defaultPeriod": {
"days": 30,
"fullHistory": false
}
}
}
]
},
"write": {
"objects": [
{
"objectName": "<string>",
"displayName": "<string>",
"valueDefaults": {
"allowAnyFields": true
}
}
]
},
"proxy": {
"enabled": true
}
}
}