Skip to content

CHILI GraFx Environment API: Sign out of a connector connection

CHILI GraFx icon

✨ New & Improved

Sign out of a connector connection

Connectors that use OAuth 2.0 Authorization Code authorize each user individually: the first time you open a template that reads from such a connector, you sign in to the external system yourself, and CHILI GraFx keeps that authorization session for you. Until now that session could not be cleared — the only way to start over was to delete and republish the Connector, which affected every user of it.

A new endpoint ends the calling user's own authorization session for a Connector:

POST /api/v1/environment/{environment}/connectors/{connectorId}/auth/oauth-authorization-code/logout

The next time that user accesses the Connector, the sign-in flow runs again. This is useful when you need to connect as a different account in the external system, or when a session no longer works and you want to re-authorize cleanly.

Two things to know:

  • It only affects the user making the call. The session is resolved from the access token, so other users of the same Connector keep their own sessions. There is no way to sign out on someone else's behalf.
  • It requires a user token. Any user with access to the environment can call it. Integration (machine-to-machine) tokens are rejected, because OAuth 2.0 Authorization Code sessions belong to a person rather than to an integration.

See Authorization for Connectors for the details, and how OAuth 2.0 Authorization Code fits into the wider connector authorization model.

More info

Read more in the Developer Center