Spectro Cloud users API is one of 42 APIs that Spectro Cloud publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include User. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes
70 operations
across 44 paths,
and defines 100 schemas.
It is described by OpenAPI 3.2.0, at version v1.
Requests are made against a single base URL, https://edge-host-ip:5080.
70 operations44 paths100 schemas8 DELETE25 GET10 PATCH17 POST10 PUT
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://api.spectrocloud.com
Authentication
API Key
Resource Areas
1
Authentication & Security 1
Spectro Cloud users API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (Authorization).
Authorization — JWT authorization token obtained using /v1/users/default/login API
Paths & Operations 70
Across 44 paths, the API surfaces 70 operations — 8 DELETE, 25 GET, 10 PATCH, 17 POST, 10 PUT. Each is listed below with its method, path, parameters, and response codes.
users 70
GET
/v1/users/current
Get current logged in user's information
V1CurrentUser→ 200500
PATCH
/v1/users/current
Patches the current logged in user's configuration
v1PatchCurrentUserbody→ 202500
POST
/v1/users/default/login
Authenticates the user with the specified credentials
V1UserLogin2 paramsbody→ 200400500
POST
/v1/users/default/logout
Logs out the user from the system
V1UserLogout→ 200400401500
POST
/v1/users/default/password/reset
Resets the user's password
V1UserPasswordResetbody→ 204400401
POST
/v1/users/default/token/renewal
Refreshes the authentication token of the user
V1UserTokenRenewal1 parambody→ 200400401500
GET
/v1/users
Lists users
v1UsersList7 params→ 200
POST
/v1/users
Create User
v1UsersCreate1 parambody→ 201
GET
/v1/users/assets/locations
Returns the specified users location
v1UsersAssetsLocationGet2 params→ 200
POST
/v1/users/assets/locations/azure
Create a Azure location
v1UsersAssetsLocationAzureCreatebody→ 201
GET
/v1/users/assets/locations/azure/{uid}
Returns the specified Azure location
v1UsersAssetsLocationAzureGet1 param→ 200
PUT
/v1/users/assets/locations/azure/{uid}
Updates the specified Azure location
v1UsersAssetsLocationAzureUpdate1 parambody→ 204
POST
/v1/users/assets/locations/gcp
Create a GCP location
v1UsersAssetsLocationGcpCreatebody→ 201
GET
/v1/users/assets/locations/gcp/{uid}
Returns the specified GCP location
v1UsersAssetsLocationGcpGet1 param→ 200
PUT
/v1/users/assets/locations/gcp/{uid}
Updates the specified GCP location
v1UsersAssetsLocationGcpUpdate1 parambody→ 204
POST
/v1/users/assets/locations/minio
Create a MinIO location
v1UsersAssetsLocationMinioCreatebody→ 201
GET
/v1/users/assets/locations/minio/{uid}
Returns the specified MinIO location
v1UsersAssetsLocationMinioGet1 param→ 200
PUT
/v1/users/assets/locations/minio/{uid}
Updates the specified MinIO location
v1UsersAssetsLocationMinioUpdate1 parambody→ 204
POST
/v1/users/assets/locations/s3
Create a S3 location
v1UsersAssetsLocationS3Createbody→ 201
DELETE
/v1/users/assets/locations/s3/{uid}
Returns the specified S3 location
v1UsersAssetsLocationS3Delete1 param→ 204
GET
/v1/users/assets/locations/s3/{uid}
Returns the specified S3 location
v1UsersAssetsLocationS3Get1 param→ 200
PUT
/v1/users/assets/locations/s3/{uid}
Updates the specified S3 location
v1UsersAssetsLocationS3Update1 parambody→ 204
PATCH
/v1/users/assets/locations/{type}/{uid}/default
Update the default backup location
v1UsersAssetsLocationDefaultUpdate2 params→ 204
DELETE
/v1/users/assets/locations/{uid}
Deletes the specified location
v1UsersAssetsLocationDelete1 param→ 204
GET
/v1/users/assets/sshkeys
Returns the SSH keys
v1UsersAssetsSshGet2 params→ 200
POST
/v1/users/assets/sshkeys
Creates a SSH key
v1UserAssetsSshCreatebody→ 201
DELETE
/v1/users/assets/sshkeys/{uid}
Returns the specified user ssh key
v1UsersAssetSshDelete1 param→ 204
GET
/v1/users/assets/sshkeys/{uid}
Returns the specified user ssh key
v1UsersAssetSshGetUid1 param→ 200
PUT
/v1/users/assets/sshkeys/{uid}
Updates the specified user ssh key
v1UsersAssetSshUpdate1 parambody→ 204
GET
/v1/users/assets/vsphere/dnsMapping
Returns the specified vSphere DNS mapping
v1VsphereMappingGet3 params→ 200
GET
/v1/users/assets/vsphere/dnsMappings
Returns the specified vSphere DNS mappings
v1VsphereDnsMappingsGet2 params→ 200
POST
/v1/users/assets/vsphere/dnsMappings
Create a vSphere DNS mapping
v1VsphereDnsMappingCreatebody→ 201
DELETE
/v1/users/assets/vsphere/dnsMappings/{uid}
Deletes the specified vSphere DNS mapping
v1VsphereDnsMappingDelete1 param→ 204
GET
/v1/users/assets/vsphere/dnsMappings/{uid}
Returns the specified vSphere DNS mapping
v1VsphereDnsMappingGet1 param→ 200
PUT
/v1/users/assets/vsphere/dnsMappings/{uid}
Updates the specified vSphere DNS mapping
v1VsphereDnsMappingUpdate1 parambody→ 204
POST
/v1/users/auth/tokens/revoke
Revoke access of specific token(s)
v1UsersAuthTokensRevokebody→ 204
GET
/v1/users/config/scar
Get the system Spectro repository. Restricted to edge services
V1UsersConfigScarGet→ 200
GET
/v1/users/info
Returns the base information of specified User
v1UsersInfoGet→ 200
GET
/v1/users/kubectl/session/{sessionUid}
gets users kubectl session
V1UsersKubectlSessionUid1 param→ 200
GET
/v1/users/meta
Retrieves a list of users metadata
v1UsersMetadata→ 200
GET
/v1/users/mfa/devices
V1UsersMfaDevicesList
V1UsersMfaDevicesList→ 200
DELETE
/v1/users/mfa/devices/{deviceName}
V1UsersMfaDevicesNameDelete
V1UsersMfaDevicesNameDelete1 param→ 204
GET
/v1/users/mfa/devices/{deviceName}
V1UsersMfaDevicesNameGet
V1UsersMfaDevicesNameGet1 param→ 200
POST
/v1/users/mfa/register/device/finish
V1UsersMfaRegisterDeviceFinish
V1UsersMfaRegisterDeviceFinishbody→ 204
POST
/v1/users/mfa/register/device/start
V1UsersMfaRegisterDeviceStart
V1UsersMfaRegisterDeviceStart1 parambody→ 200
PATCH
/v1/users/password/change
User password change request using the user emailId
V1UsersPasswordChangebody→ 204
PATCH
/v1/users/password/reset
User password reset request using the email id
v1UsersEmailPasswordResetbody→ 204
GET
/v1/users/summary
Returns the specified user summary list
v1UsersSummary3 params→ 200
POST
/v1/users/summary
Retrieves a list of users summary with provided filter spec
v1UsersSummaryGetbody→ 200
GET
/v1/users/system/features
Returns the users system feature
v1UsersSystemFeature→ 200
DELETE
/v1/users/system/macros
Delete the macros for the system user by macro name
v1UsersSystemMacrosDeleteByMacroNamebody→ 204
GET
/v1/users/system/macros
List the macros of the system
v1UsersSystemMacrosList→ 200
PATCH
/v1/users/system/macros
Update the macros for the system user by macro name
v1UsersSystemMacrosUpdateByMacroNamebody→ 204
POST
/v1/users/system/macros
Create or add new macros for the system user
v1UsersSystemMacrosCreatebody→ 204
PUT
/v1/users/system/macros
Update the macros of the system
v1UsersSystemMacrosUpdatebody→ 204
DELETE
/v1/users/{uid}
Deletes the specified User
v1UsersUidDelete1 param→ 204
GET
/v1/users/{uid}
Returns the specified User
v1UsersUidGet1 param→ 200
PATCH
/v1/users/{uid}
Patches the specified User
v1UsersUidPatch1 parambody→ 204
PUT
/v1/users/{uid}
Update User
v1UsersUidUpdate1 parambody→ 204
PATCH
/v1/users/{uid}/password/change
User password change request using the user uid
v1UsersUidPasswordChange1 parambody→ 204
PATCH
/v1/users/{uid}/password/reset
User password reset request using the user uid
v1UsersUidPasswordReset1 param→ 204
GET
/v1/users/{uid}/projects
Returns the specified User Projects and Roles information
v1UsersProjectRoles1 param→ 200
PUT
/v1/users/{uid}/projects
Updates the projects and roles for user
v1UsersProjectRolesPut1 parambody→ 204
GET
/v1/users/{uid}/resourceRoles
Returns the specified individual and resource roles for a user
v1UsersUidResourceRoles1 param→ 200
POST
/v1/users/{uid}/resourceRoles
Add resource roles for user
v1UsersUidResourceRolesCreate1 parambody→ 204
DELETE
/v1/users/{uid}/resourceRoles/{resourceRoleUid}
Deleted the resource roles from user
v1UsersUidResourceRolesUidDelete2 params→ 204
PATCH
/v1/users/{uid}/resourceRoles/{resourceRoleUid}
Updates the resource roles for user
v1UsersResourceRolesUidUpdate2 paramsbody→ 204
GET
/v1/users/{uid}/roles
Returns the specified individual and team roles for a user
v1UsersUidRoles1 param→ 200
PUT
/v1/users/{uid}/roles
Updates the roles for user
v1UsersUidRolesUpdate1 parambody→ 204
PATCH
/v1/users/{uid}/status/loginMode
Users status login mode
v1UsersStatusLoginMode1 parambody→ 204
Schemas 100
The contract defines 100 schemas that model the data the API accepts and returns. The most detailed are v1UserKubectlSession (12 properties), v1MfaPublicKeyCredentialCreationOptions (9 properties), v1AwsCloudAccount (9 properties), v1AwsSecretSpec (9 properties). Each schema is shown below with its type and property counts.
v1BadRequest
Bad request
v1UserAssetsLocationAzureSpec
object
Azure location specification
3 properties1 required
v1UserSummarySortSpec
object
2 properties
v1ProjectRolesPatch
object
1 property
v1UserSummarySortFields
stringnull
v1MfaCredentialParameter
object
2 properties
v1UserSpecEntity
object
User Entity input
6 properties
v1ResourceRoles
object
1 property
v1UserKubectlSession
object
12 properties
v1AuthTokenRevoke
object
1 property
v1UserRoleUIDs
object
1 property
v1SortOrder
string
v1ProjectRolesEntity
object
1 property
v1NoContent
No Content
v1UserUpdateEntity
object
User
2 properties
v1LocationType
string
Location type
v1MfaAuthenticatorSelection
object
4 properties
v1UsersSummaryList
object
1 property1 required
v1ListMetaData
object
ListMeta describes metadata for the resource listing
4 properties
v1Error
object
4 properties
v1FilterString
object
5 properties
v1UserSpec_2
object
User specifications
4 properties
v1UidRoleSummary
object
4 properties
v1MfaDeviceName
object
1 property
v1ObjectMeta
object
ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
7 properties
v1GcpStorageConfig
object
GCP storage config object
3 properties2 required
v1Macro
object
2 properties
v1UserAssetSshEntity
object
SSH Key request payload
2 properties
v1UidSummary
object
2 properties
v1Uid
object
1 property1 required
v1AwsCloudAccountCredentialType
string
Allowed Values [secret, sts, pod-identity]. STS type will be used for role assumption for sts type, accessKey/secretKey contains the source account, Arn is the…
v1UserAssetSshSpec
object
SSH key specification
1 property
v1UserAssetsLocationS3
object
S3 location object
2 properties
v1SystemFeature
object
2 properties
v1ObjectMetaInputEntity
object
ObjectMeta input entity for object creation
3 properties
v1MfaCredentialCreationRequest
object
8 properties
v1UsersFilterSpec
object
Users filter spec
2 properties
v1UserSpecSummary
object
7 properties
v1MfaRelyingPartyEntity
object
2 properties
v1AuthLogin
object
2 properties
v1UserAssetsLocationGcpSpec
object
GCP location specification
3 properties1 required
v1SystemScarSpec
object
system scar config spec
6 properties
v1ResourceRolesEntity
object
4 properties
v1MfaDeviceMeta
object
2 properties
v1UserAssetsLocationS3Spec
object
S3 location specification
3 properties1 required
v1MfaRegistrationStart
object
1 property
v1AwsPodIdentityCredentials
object
AWS EKS Pod Identity credentials for role assumption
2 properties
v1AwsStsCredentials
object
Aws sts credentials
2 properties
v1AzureStorageConfig
object
Azure storage config object
5 properties4 required
v1UserMetaEntity
object
User meta entity
3 properties
v1User
object
User
3 properties
v1VsphereDnsMappings
object
1 property1 required
v1Macros
object
1 property
v1HttpPatch
object
4 properties2 required
v1UserUpdateSpecEntity
object
User Entity input
4 properties
v1SystemFeaturesSpec
object
4 properties
v1Time
string
Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time pack…
v1UserEntity
object
User
2 properties
v1InternalServerError
Internal Server Error
v1UserAssetsLocations
object
1 property1 required
v1AwsSecretTlsConfig
object
TLS configuration for the AWS secret
3 properties
v1MfaConveyancePreference
string
v1MfaPublicKeyCredentialCreationOptions
object
9 properties
v1UserRolesEntity
object
2 properties
v1UserSummary
object
User summary
3 properties
v1AwsSecretSpec
object
AWS cloud account which includes access key and secret key in case of 'secret' credentials type. It includes policyARNS, ARN and externalId in case of sts. Par…
9 properties
v1UsersSummary
object
Deprecated, Use v1UsersSummaryList - Returns User summary
2 properties1 required
v1Users
object
2 properties1 required
urlEncodedBase64
string
v1UserAssetsLocationSpec
object
Location specification
3 properties
v1AcceptedResponseWithMessage
object
Accepted response with message
1 property
v1UserAssetsLocationAzure
object
Azure location object
2 properties
v1.AzureAccountEntitySpec
object
5 properties
v1VsphereDnsMappingSpec
object
VSphere DNS Mapping Spec
5 properties4 required
v1UserAssetsLocationGcp
object
GCP location object
2 properties
v1LoginSuccess
object
System login success response
2 properties
v1MfaCredentialDescriptor
object
4 properties
v1MfaDevices
array
v1MfaUserEntity
object
3 properties
v1UserStatus
object
User status
4 properties
v1UserAssetsSsh
object
1 property1 required
v1UserSpec
object
Current user information
3 properties
v1UserInfo
object
User basic information
3 properties
v1UsersMetadata
object
1 property1 required
v1UserStatusLoginMode
object
1 property
v1PasswordResetRequest
object
2 properties
v1SystemFeatures
object
1 property1 required
v1Unauthorized
Unauthorized
v1UserPatch
array
v1ResourceRolesUpdateEntity
object
3 properties
v1AwsCloudAccount
object
AWS cloud account which includes access key and secret key in case of 'secret' credentials type. It includes policyARNS, ARN and externalId in case of sts. It…
9 properties
URLEncodedBase64
string
v1UserAssetsLocation
object
Location object
2 properties
v1UsersSummarySpec
object
Users filter summary spec
2 properties
v1S3StorageConfig
object
S3 storage config object
7 properties3 required
v1UserToken
object
Authorization token response
2 properties
v1.GcpAccountEntitySpec
object
1 property
v1UserAssetSsh
object
SSH key information
2 properties
v1VsphereDnsMapping
object
VSphere DNS Mapping
2 properties
v1MfaAuthenticationExtensions
object
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Spectro Cloud 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.