API Reference
Log In
API Reference

Create or replace an integration credential

Creates a credential for the given integrationType, or replaces the existing one. Each organization has one credential per integrationType, except GitHub, which has one per GitHub organization (metadata.orgName). The token is checked with the provider before it is saved.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Team to read or write, as the team's hashid (the same id as /v2/api/teams/{id}). The caller must belong to it or be able to read it: 403 otherwise, 404 when no such team exists. An API key may only name its own organization. Omit it for the API key's organization, or for a signed-in user the first organization they belong to.

Body Params

The integration to connect. Supported integrationType values: github (metadata.orgName is required) and gitlab (metadata.groupPath is required).

string

The integration to connect: github or gitlab.

string

A name you choose for this credential.

string

The access token for the provider. It is checked with the provider, stored encrypted and never returned.

metadata
object | null

Settings for the integration. github requires orgName (string, the GitHub organization). gitlab requires groupPath (string, such as acme/engineering) and accepts instanceUrl (string, an http or https URL, default https://gitlab.com). github also accepts allowedRepos (array of owner/repo strings, at most 200) and enterpriseSlug (string). gitlab also accepts allowedProjects (array of group/project strings, at most 200). Both accept claudeCoAuthorPatterns (array of strings) and codingAssistantCoAuthorPatterns (object of string arrays keyed by coding assistant). The identitySources key is set by the sync, and appLinkedBy when the Revenium GitHub App is linked; neither can be sent.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*