How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Talon.One Accounts and users API

Represents account and user management, including billing email addresses and user invitations.

Talon.One Accounts and users API is one of 42 APIs that Talon.One publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Accounts and users. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and a getting-started guide.

This API exposes 30 operations across 20 paths, and defines 32 schemas. It is described by OpenAPI 3.2.0.

Requests are made against a single base URL, https://yourbaseurl.talon.one.

30 operations 20 paths 32 schemas 3 DELETE12 GET2 PATCH10 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
Base URL
https://yourbaseurl.talon.one
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

Talon.One Accounts and users API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (manager_auth). An API key is passed in the header as Authorization (management_key). By default, every request must be authenticated.

  • manager_auth — This authentication scheme relies on a bearer token that you can use to access all the endpoints of the Management API. To create the token: 1. Get a bearer to…
  • management_key — The API key authentication gives you access to the endpoints selected by the admin who created the key. Using an API key is the recommended authentication meth…

Paths & Operations 30

Across 20 paths, the API surfaces 30 operations — 3 DELETE, 12 GET, 2 PATCH, 10 POST, 3 PUT. Each is listed below with its method, path, parameters, and response codes.

Accounts and users 30

Represents account and user management, including billing email addresses and user invitations.

GET
/v1/users
List users in account
getUsers 3 params → 200
GET
/v1/users/{userId}
Get user
getUser 1 param → 200
PUT
/v1/users/{userId}
Update user
updateUser 1 param body → 200
DELETE
/v1/users/{userId}
Delete user
deleteUser 1 param → 204
GET
/v1/provisioning/okta
Validate Okta API ownership
oktaEventHandlerChallenge → 200
GET
/v1/provisioning/scim/Groups
List SCIM groups
scimGetGroups → 200
POST
/v1/provisioning/scim/Groups
Create SCIM group
scimCreateGroup body → 201
GET
/v1/provisioning/scim/Groups/{groupId}
Get SCIM group
scimGetGroup 1 param → 200
DELETE
/v1/provisioning/scim/Groups/{groupId}
Delete SCIM group
scimDeleteGroup 1 param → 204
PUT
/v1/provisioning/scim/Groups/{groupId}
Update SCIM group
scimReplaceGroupAttributes 1 param body → 200
PATCH
/v1/provisioning/scim/Groups/{groupId}
Update SCIM group attributes
scimPatchGroup 1 param body → 200
GET
/v1/provisioning/scim/Users
List SCIM users
scimGetUsers → 200
POST
/v1/provisioning/scim/Users
Create SCIM user
scimCreateUser body → 201
GET
/v1/provisioning/scim/Users/{userId}
Get SCIM user
scimGetUser 1 param → 200
DELETE
/v1/provisioning/scim/Users/{userId}
Delete SCIM user
scimDeleteUser 1 param → 204
PUT
/v1/provisioning/scim/Users/{userId}
Update SCIM user
scimReplaceUserAttributes 1 param body → 200
PATCH
/v1/provisioning/scim/Users/{userId}
Update SCIM user attributes
scimPatchUser 1 param body → 200
GET
/v1/provisioning/scim/ResourceTypes
List supported SCIM resource types
scimGetResourceTypes → 200
GET
/v1/provisioning/scim/ServiceProviderConfig
Get SCIM service provider configuration
scimGetServiceProviderConfig → 200
GET
/v1/provisioning/scim/Schemas
List supported SCIM schemas
scimGetSchemas → 200
POST
/v1/users/delete
Delete user by email address
deleteUserByEmail body → 204
POST
/v1/users/activate
Enable user by email address
activateUserByEmail body → 204
POST
/v1/users/deactivate
Disable user by email address
deactivateUserByEmail body → 204
POST
/v1/users/invite
Invite user from identity provider
inviteUserExternal body → 204
POST
/v2/invites
Invite user
createInviteV2 body → 201
POST
/v1/invite_emails
Resend invitation email
createInviteEmail body → 201
POST
/v1/password_recovery_emails
Request a password reset
createPasswordRecoveryEmail body → 204
POST
/v1/reset_password
Reset password
resetPassword body → 204
GET
/v1/accounts/{accountId}
Get account details
getAccount 1 param → 200
GET
/v1/accounts/{accountId}/analytics
Get account analytics
getAccountAnalytics 1 param → 200

Schemas 32

The contract defines 32 schemas that model the data the API accepts and returns. The most detailed are AccountAnalytics (20 properties), ScimServiceProviderConfigResponse (7 properties), UpdateUser (6 properties), NewInvitation (5 properties). Each schema is shown below with its type and property counts.

ScimResourceTypesListResponse
object
List of resource types supported by the SCIM provisioning protocol.
1 property 1 required
AccountEntity
object
1 property 1 required
NewInviteEmail
object
2 properties 2 required
Entity
object
2 properties 2 required
MutableEntity
object
1 property 1 required
UpdateUser
object
6 properties
DeleteUserRequest
Account
ScimUsersListResponse
object
List of users that have been provisioned using the SCIM protocol with an identity provider, for example, Microsoft Entra ID.
3 properties 1 required
ScimGroup
object
Define the schema for groups created using the SCIM provisioning protocol. In Talon.One, a Group corresponds to a [role](https://docs.talon.one/docs/product/ac…
NewExternalInvitation
object
Parameters for inviting a new user from an external identity provider.
3 properties 1 required
User
ScimSchemaResource
object
Resource schema definition for the SCIM provisioning protocol.
4 properties
ScimUser
object
Schema definition for users that have been provisioned using the SCIM protocol with an identity provider, for example, Microsoft Entra ID.
ActivateUserRequest
ScimResource
object
Resource definition for the SCIM provisioning protocol.
3 properties
ScimBaseGroup
object
Define the schema for base fields in a group using the SCIM provisioning protocol. Talon.One uses this schema to create roles.
2 properties
NewInvitation
object
Parameters for inviting a new user.
5 properties 1 required
ScimSchemasListResponse
object
List of resource schemas supported by the SCIM provisioning protocol.
3 properties 1 required
ScimServiceProviderConfigResponse
object
Service provider configuration details.
7 properties
NewPasswordEmail
object
1 property 1 required
EmailEntity
object
1 property 1 required
ScimPatchRequest
object
SCIM Patch request
2 properties 1 required
ScimPatchOperation
object
Patch operation that is used to update the information.
3 properties 1 required
ScimBaseUser
object
Schema definition for base user fields, provisioned using the SCIM protocol and used by Talon.One.
4 properties
ScimGroupMember
object
Member of the SCIM group. In Talon.One, the member is a [user](https://docs.talon.one/docs/product/account/account-settings/managing-users) assigned to a speci…
2 properties
DeactivateUserRequest
NewAccount
object
1 property 1 required
AccountAnalytics
object
20 properties 20 required
NewPassword
object
2 properties 2 required
ScimNewUser
object
Payload for users that are created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID.
1 required
ScimGroupsListResponse
object
List of groups created using the SCIM provisioning protocol with an identity provider, for example, Microsoft Entra ID. In Talon.One, a Group corresponds to a…
3 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

talon-one-accounts-and-users-api-openapi.yml Raw ↑

Other APIs Talon.One publishes across the network.

Talon.One Achievements API
Talon.One Additional costs API
Talon.One Analytics API
Talon.One Applications API
Talon.One Attributes API
Talon.One Audiences API
Talon.One Braze API
Talon.One Campaign access groups API
Talon.One Campaign notifications API
Talon.One Campaign templates API
Talon.One Campaigns API
Talon.One Catalogs API
Where this information came from

This is an independent, third-party profile of Talon.One Accounts and users API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.