> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/nemo-platform/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo-platform/_mcp/server. # Create Access Key POST https://host.com/apis/auth/v2/access-keys Content-Type: application/json Reference: https://docs.nvidia.com/nemo-platform/nemo-platform/documentation/reference/api-reference/scoped-access-keys/create-access-key-apis-auth-v-2-access-keys-post ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: Nemo Platform API version: 1.0.0 paths: /apis/auth/v2/access-keys: post: operationId: create-access-key-apis-auth-v-2-access-keys-post summary: Create Access Key tags: - scopedAccessKeys responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AccessKeyCreateResponse' '400': description: Scoped Access Key creation error content: application/json: schema: $ref: '#/components/schemas/AccessKeyErrorResponse' '404': description: Scoped Access Keys are not enabled content: application/json: schema: $ref: '#/components/schemas/AccessKeyErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '501': description: Not Implemented content: application/json: schema: $ref: '#/components/schemas/AccessKeyNotImplementedErrorResponse' requestBody: content: application/json: schema: $ref: '#/components/schemas/AccessKeyCreateRequest' servers: - url: https://host.com description: Default components: schemas: AccessKeyCreateRequest: type: object properties: name: type: string description: >- Optional human-readable Scoped Access Key label. The token jti remains the stable identifier. expires_in_seconds: type: integer description: >- Scoped Access Key lifetime in seconds. Omit to use auth.access_keys.default_expires_in_seconds. Send explicit null to request a non-time-delimited key, which requires auth.access_keys.max_expires_in_seconds to be disabled. description: Request body for creating a Scoped Access Key. title: AccessKeyCreateRequest AccessKeyCreateResponse: type: object properties: jti: type: string description: Stable JWT ID for this Scoped Access Key. name: type: string description: Optional human-readable Scoped Access Key label. principal: type: string description: Principal ID stamped into the token. created_at: type: string format: date-time expires_at: type: string format: date-time token: type: string token_type: type: string enum: - Bearer required: - jti - principal - created_at - token - token_type description: Create response. The token value is returned only once. title: AccessKeyCreateResponse AccessKeyErrorResponse: type: object properties: detail: type: string required: - detail description: Scoped Access Key error response. title: AccessKeyErrorResponse ValidationErrorLocItems: oneOf: - type: string - type: integer title: ValidationErrorLocItems ValidationError: type: object properties: loc: type: array items: $ref: '#/components/schemas/ValidationErrorLocItems' msg: type: string type: type: string input: description: Any type ctx: type: object additionalProperties: description: Any type required: - loc - msg - type title: ValidationError HTTPValidationError: type: object properties: detail: type: array items: $ref: '#/components/schemas/ValidationError' title: HTTPValidationError AccessKeyNotImplementedErrorResponse: type: object properties: detail: type: string required: - detail description: Response returned by unsupported Scoped Access Key lifecycle endpoints. title: AccessKeyNotImplementedErrorResponse ``` ## Examples **Request** ```json {} ``` **Response** ```json { "jti": "a3f1c9e2-4b7d-4f8a-9d3e-2b7f5c6a1d9e", "principal": "user_1234567890", "created_at": "2024-01-15T09:30:00Z", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "Bearer", "name": "ProjectX Access Key", "expires_at": "2024-07-15T09:30:00Z" } ``` **SDK Code** ```python import requests url = "https://host.com/apis/auth/v2/access-keys" payload = {} headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://host.com/apis/auth/v2/access-keys'; const options = {method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{}'}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://host.com/apis/auth/v2/access-keys" payload := strings.NewReader("{}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://host.com/apis/auth/v2/access-keys") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Content-Type"] = 'application/json' request.body = "{}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://host.com/apis/auth/v2/access-keys") .header("Content-Type", "application/json") .body("{}") .asString(); ``` ```php request('POST', 'https://host.com/apis/auth/v2/access-keys', [ 'body' => '{}', 'headers' => [ 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://host.com/apis/auth/v2/access-keys"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Content-Type": "application/json"] let parameters = [] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://host.com/apis/auth/v2/access-keys")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```