Create session

cURL

curl --request POST \
  --url https://us.infisical.com/api/v1/agent-vault/sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "accessBundles": [
    "<string>"
  ],
  "ttl": "7d"
}
'

import requests

url = "https://us.infisical.com/api/v1/agent-vault/sessions"

payload = {
    "accessBundles": ["<string>"],
    "ttl": "7d"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({accessBundles: ['<string>'], ttl: '7d'})
};

fetch('https://us.infisical.com/api/v1/agent-vault/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://us.infisical.com/api/v1/agent-vault/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accessBundles' => [
        '<string>'
    ],
    'ttl' => '7d'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://us.infisical.com/api/v1/agent-vault/sessions"

	payload := strings.NewReader("{\n  \"accessBundles\": [\n    \"<string>\"\n  ],\n  \"ttl\": \"7d\"\n}")

	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(string(body))

}

HttpResponse<String> response = Unirest.post("https://us.infisical.com/api/v1/agent-vault/sessions")
  .header("Content-Type", "application/json")
  .body("{\n  \"accessBundles\": [\n    \"<string>\"\n  ],\n  \"ttl\": \"7d\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://us.infisical.com/api/v1/agent-vault/sessions")

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 = "{\n  \"accessBundles\": [\n    \"<string>\"\n  ],\n  \"ttl\": \"7d\"\n}"

response = http.request(request)
puts response.read_body

{
  "session": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "token": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "accessBundles": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "position": 123
      }
    ]
  }
}

{
  "reqId": "<string>",
  "statusCode": 400,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 401,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 403,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 404,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 422,
  "error": "<string>",
  "message": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 500,
  "message": "<string>",
  "error": "<string>"
}

POST

api

agent-vault

sessions

cURL

curl --request POST \
  --url https://us.infisical.com/api/v1/agent-vault/sessions \
  --header 'Content-Type: application/json' \
  --data '
{
  "accessBundles": [
    "<string>"
  ],
  "ttl": "7d"
}
'

import requests

url = "https://us.infisical.com/api/v1/agent-vault/sessions"

payload = {
    "accessBundles": ["<string>"],
    "ttl": "7d"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({accessBundles: ['<string>'], ttl: '7d'})
};

fetch('https://us.infisical.com/api/v1/agent-vault/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://us.infisical.com/api/v1/agent-vault/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'accessBundles' => [
        '<string>'
    ],
    'ttl' => '7d'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://us.infisical.com/api/v1/agent-vault/sessions"

	payload := strings.NewReader("{\n  \"accessBundles\": [\n    \"<string>\"\n  ],\n  \"ttl\": \"7d\"\n}")

	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(string(body))

}

HttpResponse<String> response = Unirest.post("https://us.infisical.com/api/v1/agent-vault/sessions")
  .header("Content-Type", "application/json")
  .body("{\n  \"accessBundles\": [\n    \"<string>\"\n  ],\n  \"ttl\": \"7d\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://us.infisical.com/api/v1/agent-vault/sessions")

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 = "{\n  \"accessBundles\": [\n    \"<string>\"\n  ],\n  \"ttl\": \"7d\"\n}"

response = http.request(request)
puts response.read_body

{
  "session": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "token": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z",
    "accessBundles": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "position": 123
      }
    ]
  }
}

{
  "reqId": "<string>",
  "statusCode": 400,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 401,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 403,
  "message": "<string>",
  "error": "<string>",
  "details": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 404,
  "message": "<string>",
  "error": "<string>"
}

{
  "reqId": "<string>",
  "statusCode": 422,
  "error": "<string>",
  "message": "<unknown>"
}

{
  "reqId": "<string>",
  "statusCode": 500,
  "message": "<string>",
  "error": "<string>"
}

Body

application/json

accessBundles

string[]

required

The access bundle this session carries, by name. A list that accepts exactly one name.

Required array length: 1 element

Required string length: 1 - 64

ttl

string

default:7d

How long the session lasts: a duration such as 30m, 8h or 7d (at least 1m), or never. Defaults to 7d.

Response

Default Response

session

object

required

Show child attributes

Get started

Organization

Project

Shared

Identity auth

Secrets management

Certificate management

Secret sharing

Infisical KMS

Agent Vault

KMIP servers

Gateways

External migrations

Other

Body

Response