PUT /v1/agent-cards/policy

Set the organization's card-disclosure mode to `off`, `preapproved` or `always`. Signed-in users only, and gated on the org-wide safety tier: this one setting decides whether a human looks at each disclosure at all.

PUT /v1/agent-cards/policy
Set the organization's card-disclosure mode to `off`, `preapproved` or `always`. Signed-in users only, and gated on the org-wide safety tier: this one setting decides whether a human looks at each disclosure at all.

Request Body required

Disclosure mode

application/json
One of:
Option 1
Option 2
mode string REQUIRED

Responses

200 OK
application/json
code integer
data object
mode string
message string
requestId string
400 Bad Request
403 Forbidden 
curl -X PUT 'https://api.example.com/v1/agent-cards/policy' \  -H 'Authorization: Bearer YOUR_API_TOKEN' \  -H 'Content-Type: application/json' \  -d '{}'
const response = await fetch('https://api.example.com/v1/agent-cards/policy', {  method: 'PUT',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN",      "Content-Type": "application/json"  },  body: JSON.stringify({})});const data = await response.json();console.log(data);
import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.put('https://api.example.com/v1/agent-cards/policy', headers=headers, json={})print(response.json())
package mainimport (	"fmt"	"io"	"net/http"	"strings")func main() {	body := strings.NewReader(`{}`)	req, _ := http.NewRequest("PUT", "https://api.example.com/v1/agent-cards/policy", body)	req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")	req.Header.Set("Content-Type", "application/json")	resp, _ := http.DefaultClient.Do(req)	defer resp.Body.Close()	result, _ := io.ReadAll(resp.Body)	fmt.Println(string(result))}
200 Response 
{  "code": 200,  "data": {    "mode": "preapproved"  },  "message": "success",  "requestId": "abc-123"}
Previous GET /v1/agent-cards/policy
Next GET /v1/agent-cards/requests