Complete authorization on a connection

Polls one authorization attempt no earlier than next_poll_time. Only an explicit pending response allows another provider poll. Unknown outcomes require a new authorization; successful credentials are sealed and committed before the Connection becomes active. A completed attempt is safe to replay.

• Path POST https://api.sylphx.com/v1/orgs/acme/connections/connection:completeAuthorization
• Scope connections:write
• Effect write — a successful call changes state.
• Collection connections
• Operation answers with an Operation; the result is Connection

#Request

#Response

#ProblemDetails

#OperationProgress

#Condition

#Errors

• UNAUTHENTICATED — No valid key or token was presented.
• PERMISSION_DENIED — The key lacks the method's permission.
• INVALID_FIELD — A field failed validation.
• INVALID_STATE — The Resource is in a state that forbids the call.
• RESOURCE_NOT_FOUND — The named Resource does not exist or is not visible.
• IDEMPOTENCY_KEY_REUSED — An Idempotency-Key was reused with another body.
• IDEMPOTENCY_IN_PROGRESS — The first call with this Idempotency-Key is still running.
• UNAVAILABLE — The Resource store, the owning service's backend, or the key verifier's snapshot is unavailable; retry after Retry-After.

Every error arrives in the body Errors describes.

#Examples

curl -X POST "https://api.sylphx.com/v1/orgs/acme/connections/connection:completeAuthorization" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"authorization_id":"…"}'