Get started
Webhooks

organization.ai_provider_config

organization.ai_provider_config

Subscribe an endpoint to every event on this page with organization.ai_provider_config.*. Each is the envelope every webhook event shares, with the AiProviderConfigEventObject object as its data.object.

Event typeWhat happened
organization.ai_provider_config.createdAn AI provider was configured.
organization.ai_provider_config.updatedAn AI provider configuration changed.
organization.ai_provider_config.deletedAn AI provider configuration was deleted.

The AiProviderConfigEventObject object

An organization's AI provider configuration as a webhook event carries it: the provider, the model, and the hint of the credential, which is never carried.

object

string

required

One of: organization.ai_provider_config

The kind of object this is, always organization.ai_provider_config: the family of the event types that carry it, and what tells the members of WebhookEventObject apart.

organization_id

string (uuid)

required

Identifier of the organization the configuration belongs to.

provider

string

required

One of: anthropic, mistral

The provider agent runs are routed through.

model

string

required

The provider's model agent runs use.

credential_hint

string

required

The last four characters of the stored credential, as getOrganizationAiProviderConfig shows them, and empty for a credential shorter than 12 characters, of which four would be too large a part.

version

integer (int64)

required

The configuration's version once this change was made. It climbs with every change a read of the configuration shows, so of two events about one configuration the one carrying the higher version is the later state: events are not delivered in order. A delete is the configuration's last version change: organization.ai_provider_config.deleted carries a version past every one the configuration held, and below the one a configuration created afterwards starts at, so an event that arrives after the delete is never mistaken for the later state.

organization.ai_provider_config.created

An organization's AI provider configuration was created.

Triggered by

Payload

type

string

required

One of: organization.ai_provider_config.created

Always organization.ai_provider_config.created.

data.object

AiProviderConfigEventObject

required

The AI provider configuration.

See the AiProviderConfigEventObject object.

Every other field is the envelope every webhook event shares.

organization.ai_provider_config.updated

An organization's AI provider configuration was written: its model, its credential or its base URL.

Triggered by

  • organization.ai_provider_config.update: When the model or the base URL changes, or when a credential is sent, which replaces the one stored. A request sending the model and the base URL already held, and no credential, writes nothing and records nothing.
    • PATCH /v1/organizations/{organization_id}/ai-provider-config: patchOrganizationAiProviderConfig, mountaya.admin.organizations.patchOrganizationAiProviderConfig() in TypeScript. Every change accepted.

Payload

type

string

required

One of: organization.ai_provider_config.updated

Always organization.ai_provider_config.updated.

data.object

AiProviderConfigEventObject

required

The AI provider configuration.

See the AiProviderConfigEventObject object.

data.previous_attributes

object

The former value of each field of data.object the change moved, and of no other.

Every other field is the envelope every webhook event shares.

organization.ai_provider_config.deleted

An organization's AI provider configuration was deleted, its credential with it.

Triggered by

Payload

type

string

required

One of: organization.ai_provider_config.deleted

Always organization.ai_provider_config.deleted.

data.object

AiProviderConfigEventObject

required

The AI provider configuration.

See the AiProviderConfigEventObject object.

Every other field is the envelope every webhook event shares.