{ "opencollection": "1.0.0", "info": { "name": "ALTR Sidecar/Agent Configuration Repo Users API", "version": "1.0.0" }, "items": [ { "info": { "name": "Repo Users", "type": "folder" }, "items": [ { "info": { "name": "List all users for a repo.", "type": "http" }, "http": { "method": "GET", "url": "https://{orgID}.sc-control.live.altr.com/v1/repos/:repo_name/users", "params": [ { "name": "limit", "value": "", "type": "query", "description": "The maximum number of items to return." }, { "name": "contiguous_id", "value": "", "type": "query", "description": "The Contiguous ID for pagination" }, { "name": "repo_name", "value": "", "type": "path", "description": "The name of the repo to list users for." } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "List all users for a repo." }, { "info": { "name": "Create a new Repo User.", "type": "http" }, "http": { "method": "POST", "url": "https://{orgID}.sc-control.live.altr.com/v1/repos/:repo_name/users", "params": [ { "name": "repo_name", "value": "", "type": "path", "description": "Name of repo." } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Create a new Repo User with the provided details. Exactly one credential provider must be specified:\n\n- **aws_secrets_manager** — reference a secret in AWS Secrets Manager (fields: secrets_path, optional iam_role).\n- **azure_key_vault** — reference a secret in Azure Key Vault (fields: key_vault_uri, secret_name).\n- **environment_variable** — read the credential from an OS environment variable (field: variable_name).\n- **secret_file** — read the credential from a file under /altr/secrets/ (field:" }, { "info": { "name": "Get a Repo User.", "type": "http" }, "http": { "method": "GET", "url": "https://{orgID}.sc-control.live.altr.com/v1/repos/:repo_name/users/:username", "params": [ { "name": "repo_name", "value": "", "type": "path", "description": "Name of repo." }, { "name": "username", "value": "", "type": "path", "description": "Name of user." } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Get the user for a given repo name and user name." }, { "info": { "name": "Update a Repo User.", "type": "http" }, "http": { "method": "PATCH", "url": "https://{orgID}.sc-control.live.altr.com/v1/repos/:repo_name/users/:username", "body": { "type": "json", "data": "{}" }, "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Update a Repo User. When changing the credential provider, supply exactly one of:\n\n- **aws_secrets_manager** — reference a secret in AWS Secrets Manager (fields: secrets_path, optional iam_role).\n- **azure_key_vault** — reference a secret in Azure Key Vault (fields: key_vault_uri, secret_name).\n- **environment_variable** — read the credential from an OS environment variable (field: variable_name).\n- **secret_file** — read the credential from a file under /altr/secrets/ (field: path). The path mu" }, { "info": { "name": "Delete a Repo User.", "type": "http" }, "http": { "method": "DELETE", "url": "https://{orgID}.sc-control.live.altr.com/v1/repos/:repo_name/users/:username", "params": [ { "name": "repo_name", "value": "", "type": "path", "description": "Name of Repo." }, { "name": "username", "value": "", "type": "path", "description": "Name of User." } ], "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "docs": "Delete a user from a Repo." } ] } ], "bundled": true }