{"type":"model","meta":{"id":"/apps/pubhub/media/cloud-security-apis-in-eft/83e8a10367d157243cd1c3e478b807cb81262a3d/55187620-d35e-353c-8340-4b81462250a3","info":{"version":"1.0.0","title":"Cisco Secure Access Identities Registration API","description":"Manage the Secure Access identity endpoints and security groups tags (SGTs) for the identities in the organization.","contact":{"name":"Cloud Security Developer Community"}},"security":[{"oauthFlow":[]}],"tags":[{"name":"Identities"},{"name":"Secure Access"}],"x-parser-conf":{"overview":{"markdownPath":"secure-access/reference/deployments/identities-registration-overview.md","uri":"secure-access-api-reference-identities-registration-overview"}},"openapi":"3.0.2","servers":[{"url":"https://api.sse.cisco.com/{basePath}","variables":{"basePath":{"default":"deployments/v2"}}}],"securitySchemes":{"oauthFlow":{"type":"oauth2","description":"The client credential flow.","flows":{"clientCredentials":{"tokenUrl":"https://api.sse.cisco.com/auth/v2/token","scopes":{"deployments.identities:read":"Read the identity endpoint or security group tag.","deployments.identities:write":"Update the identity endpoint or security group tag."}}}}}},"spec":{"type":"array","maxItems":250,"description":"The list of identities in the collection returned for either the `device` or `securityGroupTag` identity type.","items":{"oneOf":[{"type":"object","description":"The properties of the identity endpoint.","required":["key","label","status","authName","createdAt","modifiedAt"],"properties":{"key":{"type":"string","description":"The unique identifier specified in the UUID4 format. The key is used for all identity endpoints or security group tags.","example":"123e4567-e89b-12d3-a456-426614174001","$$ref":"#/components/schemas/key"},"label":{"type":"string","description":"The descriptive name assigned to the identity endpoint or security group tag.","example":"device one","$$ref":"#/components/schemas/label"},"status":{"type":"string","description":"The state of the identity endpoint or security group tag.","enum":["active","inactive"],"example":"active","$$ref":"#/components/schemas/status"},"authName":{"type":"string","description":"The attribute used to authenticate the identity endpoint.","example":"auth_device_beta","$$ref":"#/components/schemas/authName"},"createdAt":{"type":"integer","description":"The date and time in nanoseconds since the Unix Epoch when the system created the identity.","format":"int64","example":1753870525233159700,"$$ref":"#/components/schemas/createdAt"},"modifiedAt":{"type":"integer","description":"The date and time in nanoseconds since the Unix Epoch when the system updated the identity.","example":1753870525233159700,"$$ref":"#/components/schemas/modifiedAt"}},"example":{"key":"123e4567-e89b-12d3-a456-426614174001","label":"Device Alpha","status":"active","authName":"auth_device_alpha","createdAt":17538705252331596000,"modifiedAt":1753870525233159700},"$$ref":"#/components/schemas/IdentityEndpointsGetResponse"},{"type":"object","description":"The properties of the security group tag.","required":["key","label","status","tagId","createdAt","modifiedAt"],"properties":{"key":{"type":"string","description":"The unique identifier specified in the UUID4 format. The key is used for all identity endpoints or security group tags.","example":"123e4567-e89b-12d3-a456-426614174001","$$ref":"#/components/schemas/key"},"label":{"type":"string","description":"The descriptive name assigned to the identity endpoint or security group tag.","example":"device one","$$ref":"#/components/schemas/label"},"status":{"type":"string","description":"The state of the identity endpoint or security group tag.","enum":["active","inactive"],"example":"active","$$ref":"#/components/schemas/status"},"tagId":{"type":"integer","format":"int64","description":"The unique identifier of the security group tag.","$$ref":"#/components/schemas/tagId"},"createdAt":{"type":"integer","description":"The date and time in nanoseconds since the Unix Epoch when the system created the identity.","format":"int64","example":1753870525233159700,"$$ref":"#/components/schemas/createdAt"},"modifiedAt":{"type":"integer","description":"The date and time in nanoseconds since the Unix Epoch when the system updated the identity.","example":1753870525233159700,"$$ref":"#/components/schemas/modifiedAt"}},"example":{"key":"123e4567-e89b-12d3-a456-426614174001","label":"Device Alpha","status":"active","tagId":12345671234564266,"createdAt":17538705252331596000,"modifiedAt":1753870525233159700},"$$ref":"#/components/schemas/SecurityGroupTagIdentityGetResponse"}]},"example":[{"key":"123e4567-e89b-12d3-a456-426614174001","label":"Device Alpha","status":"active","authName":"auth_device_alpha","createdAt":17538705252331596000,"modifiedAt":1753870525233159700}],"$$ref":"#/components/schemas/IdentitiesGetResponse","title":"IdentitiesGetResponse"}}