curl --request GET \
--url 'https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public', {
method: 'GET',
headers: {
Authorization: 'Bearer fini_your_api_key'
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
data = response.json()
[
{
"id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"name": "Cancel subscription",
"description": "Cancel an active subscription in billing.",
"inputFields": [
{
"name": "customerId",
"type": "string",
"required": true
}
],
"outputFields": [
{
"name": "confirmationId",
"type": "string"
},
{
"name": "effectiveDate",
"type": "string"
}
],
"createdAt": "2026-07-28T08:55:32.000Z",
"updatedAt": "2026-07-28T09:10:18.000Z"
}
]
Actions
List agent assignments
List the agents an action is assigned to.
GET
/
v2
/
hc-tools
/
{id}
/
junctions
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public', {
method: 'GET',
headers: {
Authorization: 'Bearer fini_your_api_key'
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
data = response.json()
[
{
"id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"name": "Cancel subscription",
"description": "Cancel an active subscription in billing.",
"inputFields": [
{
"name": "customerId",
"type": "string",
"required": true
}
],
"outputFields": [
{
"name": "confirmationId",
"type": "string"
},
{
"name": "effectiveDate",
"type": "string"
}
],
"createdAt": "2026-07-28T08:55:32.000Z",
"updatedAt": "2026-07-28T09:10:18.000Z"
}
]
Returns the agent assignments for one action.
Action assignments are stored but not enforced at runtime; whether an agent can invoke an action is decided by Rulebook wiring and the rule’s own agent assignments. See Assign to agents.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs read scope.Path parameters
string
required
Action ID whose assignments you want.
Response
Returns a top-level array ofAgent assignment objects.
curl --request GET \
--url 'https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public', {
method: 'GET',
headers: {
Authorization: 'Bearer fini_your_api_key'
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/hc-tools/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/junctions/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
data = response.json()
[
{
"id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"name": "Cancel subscription",
"description": "Cancel an active subscription in billing.",
"inputFields": [
{
"name": "customerId",
"type": "string",
"required": true
}
],
"outputFields": [
{
"name": "confirmationId",
"type": "string"
},
{
"name": "effectiveDate",
"type": "string"
}
],
"createdAt": "2026-07-28T08:55:32.000Z",
"updatedAt": "2026-07-28T09:10:18.000Z"
}
]
Errors
401 Unauthorized
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
403 Forbidden
The API key does not include the
read scope required for this route.Was this page helpful?