canonical: https://jentic.com/apis/sailpoint.com/sailpoint

# SailPoint IdentityNow V3 API

SailPoint IdentityNow V3 API for identity governance, access management, certifications, and provisioning. The API exposes 18 endpoints secured with oauth2 authentication.

## For AI agents

Programmatically list identities, get identity. Covers 18 operations with oauth2 authentication.

## Scope

Does not handle payments, communications, or crm - use for identity and authentication only.

## Capabilities

- List identities
- Get identity
- Create source
- Query and filter SailPoint IdentityNow V3 API records by parameters
- Monitor SailPoint IdentityNow V3 API operational status and events

## Use cases

### Identity and Authentication Operations

Use the SailPoint IdentityNow V3 API to perform identity auth operations programmatically. The API provides 18 endpoints covering core functionality including list identities, get identity, list accounts.

Example prompt: Call GET `/v3/identities` to list identities

### Automated Access Profiles Management

Automate access profiles operations by combining multiple SailPoint IdentityNow V3 API endpoints. Agents can get identity and then list accounts in a single workflow.

Example prompt: Call GET `/v3/identities/{id}` to get identity, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call SailPoint IdentityNow V3 API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle oauth2 tokens manually.

Example prompt: Search Jentic for 'list identities', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v3/identities` | List identities |
| GET | `/v3/identities/{id}` | Get identity |
| GET | `/v3/accounts` | List accounts |
| GET | `/v3/accounts/{id}` | Get account |
| POST | `/v3/sources` | Create source |
| GET | `/v3/sources` | List sources |
| GET | `/v3/sources/{id}` | Get source |
| PUT | `/v3/sources/{id}` | Update source |

## Key resources

- **Access Profiles** — Operations related to Access Profiles
- **Accounts** — Operations related to Accounts
- **Certifications** — Operations related to Certifications
- **Identities** — Operations related to Identities
- **Roles** — Operations related to Roles

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 71 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 83 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 50 / 100
  - Agent Usability: 94 / 100
  - Security: 85 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/sailpoint.com/sailpoint/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the SailPoint IdentityNow V3 API by hand means running its OAuth2 flow, pointing at your tenant.api.identitynow.com host, and managing your own token refresh and retries. Through Jentic you install once, import the SailPoint IdentityNow V3 API from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** SailPoint puts the source id in the URL path (`/v3/sources/{id}`), so a rule can pin your agent to one source: it can read and update that source and nothing else. You choose the operations it may call, so you can allow read-only lookups of identities and accounts without granting source creation or updates unless you add them.
- **Credential handling:** Your SailPoint IdentityNow V3 API credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list identities' or 'look up an account', and Jentic returns the matching SailPoint IdentityNow V3 API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Auth0** — Alternative identity auth API
- **Okta** — Alternative identity auth API

## FAQ

### What authentication does the SailPoint IdentityNow V3 API use?

The SailPoint IdentityNow V3 API uses OAuth 2.0 for authorization. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I list identities with the SailPoint IdentityNow V3 API?

Yes. Use the GET `/v3/identities` endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the SailPoint IdentityNow V3 API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I list identities through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'list identities'. Jentic returns the matching SailPoint IdentityNow V3 API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the SailPoint IdentityNow V3 API have?

The SailPoint IdentityNow V3 API exposes 18 endpoints covering access profiles, accounts, certifications operations.

### Can I limit what my agent is allowed to do with the SailPoint IdentityNow V3 API?

Yes. Jentic One is self-hosted, so you run it and your own rules decide which SailPoint operations and credentials the agent may use. Because SailPoint puts the source id in the URL path (`/v3/sources/{id}`), you can pin the agent to a single source and let it read and update only that one. You can also allow read-only lookups such as GET `/v3/identities` and GET `/v3/accounts` while withholding source creation and updates until you choose to grant them.