Refresh connector fields
Read the fields of the connector from the connector itself, and store what came back. Returns when the fields are stored, so GET /connectors/{id}/fields lists them straight after. One connector accepts this once every 15 minutes. A connector that cannot serve its fields keeps the stored ones and answers outcome: kept with a reason. Either way retryAt says when the next refresh is accepted.
curl -X POST "https://api.corma.io/v1/connectors/{id}/fields/refresh" \
-H "x-corma-api-key: $CORMA_OPEN_API_KEY"Authorization
x-corma-api-keystringheaderrequiredColon-separated API key ID and secret:
API_KEY_ID:API_KEY_SECRET
Parameters
idstringpathrequiredThe identifier of the connector, as
GET /connectorsreturned it, or the id of its connection. Thekind.methodform names the only connection of that integration; with several, it answers 409.x-corma-idempotency-keystringheaderOptional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.
Response
OK
refreshedAtstring<date-time> | nullrequiredThe timestamp of the last catalog refresh. ISO 8601 format. Null when Corma never read the catalog of this connector.
outcomeenum<string>requiredreplacedwhen Corma read the fields and stored them.keptwhen the connector cannot serve its fields, so the stored ones stay.no-fetcherwhen Corma cannot read the fields of this connector at all.One of:replacedkeptno-fetcherreasonenum<string> | nullrequiredWhy the fields were kept.
missing-permission: the connection was not granted the permission to read its fields.no-valid-credentials: the connection must be reconnected. Null unlessoutcomeiskept.One of:missing-permissionno-valid-credentialsretryAtstring<date-time> | nullrequiredWhen this connector accepts the next refresh. ISO 8601 format. Null when this call started no cooldown.
{
"refreshedAt": "2026-01-15T09:30:00Z",
"outcome": "replaced",
"reason": "missing-permission",
"retryAt": "2026-01-15T09:30:00Z"
}