Set agent file availability

PUT

file-library

files

{id}

availability

Set agent file availability

curl --request PUT \
  --url https://api.getnexor.ai/api/public/file-library/files/{id}/availability \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "workflow_ids": [
    "22222222-2222-4222-8222-222222222222",
    "33333333-3333-4333-8333-333333333333"
  ],
  "enabled": false
}
'

import requests

url = "https://api.getnexor.ai/api/public/file-library/files/{id}/availability"

payload = {
    "workflow_ids": ["22222222-2222-4222-8222-222222222222", "33333333-3333-4333-8333-333333333333"],
    "enabled": False
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    workflow_ids: ['22222222-2222-4222-8222-222222222222', '33333333-3333-4333-8333-333333333333'],
    enabled: false
  })
};

fetch('https://api.getnexor.ai/api/public/file-library/files/{id}/availability', 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://api.getnexor.ai/api/public/file-library/files/{id}/availability",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'workflow_ids' => [
        '22222222-2222-4222-8222-222222222222',
        '33333333-3333-4333-8333-333333333333'
    ],
    'enabled' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$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://api.getnexor.ai/api/public/file-library/files/{id}/availability"

	payload := strings.NewReader("{\n  \"workflow_ids\": [\n    \"22222222-2222-4222-8222-222222222222\",\n    \"33333333-3333-4333-8333-333333333333\"\n  ],\n  \"enabled\": false\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	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.put("https://api.getnexor.ai/api/public/file-library/files/{id}/availability")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"workflow_ids\": [\n    \"22222222-2222-4222-8222-222222222222\",\n    \"33333333-3333-4333-8333-333333333333\"\n  ],\n  \"enabled\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/file-library/files/{id}/availability")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"workflow_ids\": [\n    \"22222222-2222-4222-8222-222222222222\",\n    \"33333333-3333-4333-8333-333333333333\"\n  ],\n  \"enabled\": false\n}"

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

{
  "success": true,
  "file_id": "8a1f2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
  "workflow_ids": [
    "22222222-2222-4222-8222-222222222222",
    "33333333-3333-4333-8333-333333333333"
  ],
  "enabled": false
}

Removing a file from a task is not the same as deleting it:

Action	Result
This endpoint with `enabled: false`	The tasks you list stop sending the file. The file stays in the account and in every other task, and you can turn it back on with `enabled: true`.
Delete	The file is gone for every agent. There is no undo.

{
  "workflow_ids": [
    "22222222-2222-4222-8222-222222222222",
    "33333333-3333-4333-8333-333333333333"
  ],
  "enabled": false
}

workflow_ids takes task IDs, from 1 to 100. Duplicates are ignored.
To remove a file from a whole agent, send every task ID of that agent. This is what Don’t use for this agent does in the app.
Other files and other tasks are not changed.
If the file or any task is not in this account, the API returns 404 and changes nothing. The message lists the task IDs it could not find.

Authorizations

X-API-Key

string

header

required

API key for authentication. Keys are prefixed with nxr_live_. To work inside a sub-account with a main account key, also send the optional X-Nexor-Sub-Account-Id header.

Path Parameters

string<uuid>

required

File ID, from List files. A malformed ID returns 400 Validation error.

Body

application/json

workflow_ids

string<uuid>[]

required

Task IDs (workflow in the API) to change. From 1 to 100 IDs. Duplicates are removed.

Required array length: 1 - 100 elements

enabled

boolean

required

true lets these tasks send the file. false stops them.

Response

Availability saved.

success

enum<boolean>

required

Available options:

true

file_id

string<uuid>

required

workflow_ids

string<uuid>[]

required

The tasks that changed, without duplicates.

enabled

boolean

required

Last modified on September 29, 2026

Set agent file availability

curl --request PUT \
  --url https://api.getnexor.ai/api/public/file-library/files/{id}/availability \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "workflow_ids": [
    "22222222-2222-4222-8222-222222222222",
    "33333333-3333-4333-8333-333333333333"
  ],
  "enabled": false
}
'

import requests

url = "https://api.getnexor.ai/api/public/file-library/files/{id}/availability"

payload = {
    "workflow_ids": ["22222222-2222-4222-8222-222222222222", "33333333-3333-4333-8333-333333333333"],
    "enabled": False
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    workflow_ids: ['22222222-2222-4222-8222-222222222222', '33333333-3333-4333-8333-333333333333'],
    enabled: false
  })
};

fetch('https://api.getnexor.ai/api/public/file-library/files/{id}/availability', 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://api.getnexor.ai/api/public/file-library/files/{id}/availability",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'workflow_ids' => [
        '22222222-2222-4222-8222-222222222222',
        '33333333-3333-4333-8333-333333333333'
    ],
    'enabled' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$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://api.getnexor.ai/api/public/file-library/files/{id}/availability"

	payload := strings.NewReader("{\n  \"workflow_ids\": [\n    \"22222222-2222-4222-8222-222222222222\",\n    \"33333333-3333-4333-8333-333333333333\"\n  ],\n  \"enabled\": false\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	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.put("https://api.getnexor.ai/api/public/file-library/files/{id}/availability")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"workflow_ids\": [\n    \"22222222-2222-4222-8222-222222222222\",\n    \"33333333-3333-4333-8333-333333333333\"\n  ],\n  \"enabled\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/file-library/files/{id}/availability")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"workflow_ids\": [\n    \"22222222-2222-4222-8222-222222222222\",\n    \"33333333-3333-4333-8333-333333333333\"\n  ],\n  \"enabled\": false\n}"

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

{
  "success": true,
  "file_id": "8a1f2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
  "workflow_ids": [
    "22222222-2222-4222-8222-222222222222",
    "33333333-3333-4333-8333-333333333333"
  ],
  "enabled": false
}

Start here

Quickstart

API reference

Build and launch

WhatsApp

Channels

Agents

Meetings

Integrations

Account

Inbox

Insights

Developer tools

Support reference

Set agent file availability

Authorizations

Path Parameters

Body

Response