# Agility Credit SCIM API reference

SCIM 2.0 endpoints for provisioning users and groups in Agility Credit.

These endpoints implement the [SCIM 2.0 protocol](https://datatracker.ietf.org/doc/html/rfc7644)
with the same operation surface that Okta's provisioning client uses. They are intended
for IdPs (Okta, Microsoft Entra ID) and custom provisioning clients — see the
[SCIM custom integration guide](https://apidocs.agilitycredit.com/sso/scim-provisioning/custom-integration) for the
behavioural notes that don't fit a machine-readable spec (PATCH normalization rules,
silent-ignore semantics, virtual groups, tenant-configurable role attribute, etc.).

Version: 2.0

## Servers

- Production: `https://api.agilitycredit.net/scim/v2/{tenantId}`
- UAT: `https://api.agc-dev.com/scim/v2/{tenantId}`

## Authentication

HTTP Bearer: send `Authorization: Bearer <api key>` on every request.

## Endpoints

- [Get service provider configuration](https://apidocs.agilitycredit.com/sso/scim-api/get-service-provider-config.md): `GET /ServiceProviderConfig`
- [List schemas](https://apidocs.agilitycredit.com/sso/scim-api/list-schemas.md): `GET /Schemas`
- [Get a schema](https://apidocs.agilitycredit.com/sso/scim-api/get-schema.md): `GET /Schemas/{schemaId}`
- [List users](https://apidocs.agilitycredit.com/sso/scim-api/list-users.md): `GET /Users`
- [Create user](https://apidocs.agilitycredit.com/sso/scim-api/create-user.md): `POST /Users`
- [Get user](https://apidocs.agilitycredit.com/sso/scim-api/get-user.md): `GET /Users/{userId}`
- [Replace user](https://apidocs.agilitycredit.com/sso/scim-api/replace-user.md): `PUT /Users/{userId}`
- [Update user](https://apidocs.agilitycredit.com/sso/scim-api/patch-user.md): `PATCH /Users/{userId}`
- [Deactivate user](https://apidocs.agilitycredit.com/sso/scim-api/delete-user.md): `DELETE /Users/{userId}`
- [List groups](https://apidocs.agilitycredit.com/sso/scim-api/list-groups.md): `GET /Groups`
- [Create group (idempotent)](https://apidocs.agilitycredit.com/sso/scim-api/create-group.md): `POST /Groups`
- [Get group](https://apidocs.agilitycredit.com/sso/scim-api/get-group.md): `GET /Groups/{groupId}`
- [Replace group membership](https://apidocs.agilitycredit.com/sso/scim-api/replace-group.md): `PUT /Groups/{groupId}`
- [Patch group membership](https://apidocs.agilitycredit.com/sso/scim-api/patch-group.md): `PATCH /Groups/{groupId}`
- [Clear group membership](https://apidocs.agilitycredit.com/sso/scim-api/delete-group.md): `DELETE /Groups/{groupId}`

OpenAPI spec: https://apidocs.agilitycredit.com/agc-scim-openapi.yaml