curl --request GET \
--url https://api.watchdog.no/v1/approval-rules/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.watchdog.no/v1/approval-rules/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/approval-rules/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"subject": "invoice",
"fallback": true,
"position": 1,
"approvers": [
{
"user_id": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"step": 2
}
],
"approver_teams": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"step": 2
}
],
"references": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"missing": true,
"type": "supplier",
"supplier_names": [
"<string>"
]
}
],
"skipped_people": [
{
"user_id": "<string>",
"name": "<string>",
"reason": "no_access",
"count": 123,
"invoices": {
"invoices": [
{
"invoice_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
],
"supplier_name": "<string>"
}
}
],
"skipped_teams": [
{
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"reason": "nobody_can_act",
"count": 123,
"invoices": {
"invoices": [
{
"invoice_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
],
"supplier_name": "<string>"
}
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"conditions": "<unknown>",
"unassigned_invoices": {
"count": 1,
"invoices": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
]
},
"skips": {
"data": [
{
"user_id": "<string>",
"name": "<string>",
"reason": "no_access",
"invoice": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
}
],
"next_cursor": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_token",
"message": "The bearer token is missing or invalid.",
"request_id": "req_example"
}
}{
"error": {
"code": "forbidden",
"message": "Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required.",
"request_id": "req_example"
}
}{
"error": {
"code": "not_found",
"message": "The resource does not exist in the current organization.",
"request_id": "req_example"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Wait for the Retry-After delay before retrying.",
"request_id": "req_example"
}
}{
"error": {
"code": "internal_error",
"message": "Unexpected server failure. Include the request ID when contacting support.",
"request_id": "req_example"
}
}{
"error": {
"code": "service_unavailable",
"message": "Temporarily unavailable. Retry after the Retry-After delay, when provided.",
"request_id": "req_example"
}
}Get an approval rule
Read callers see the rules, conditions and approvers; who was skipped names invoices, so skipped_people and skipped_teams are empty and include=skips is refused below Admin.
curl --request GET \
--url https://api.watchdog.no/v1/approval-rules/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.watchdog.no/v1/approval-rules/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.watchdog.no/v1/approval-rules/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"subject": "invoice",
"fallback": true,
"position": 1,
"approvers": [
{
"user_id": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"step": 2
}
],
"approver_teams": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"step": 2
}
],
"references": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"missing": true,
"type": "supplier",
"supplier_names": [
"<string>"
]
}
],
"skipped_people": [
{
"user_id": "<string>",
"name": "<string>",
"reason": "no_access",
"count": 123,
"invoices": {
"invoices": [
{
"invoice_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
],
"supplier_name": "<string>"
}
}
],
"skipped_teams": [
{
"team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"reason": "nobody_can_act",
"count": 123,
"invoices": {
"invoices": [
{
"invoice_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
],
"supplier_name": "<string>"
}
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"conditions": "<unknown>",
"unassigned_invoices": {
"count": 1,
"invoices": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
]
},
"skips": {
"data": [
{
"user_id": "<string>",
"name": "<string>",
"reason": "no_access",
"invoice": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"invoice_number": "<string>",
"supplier_name": "<string>"
}
}
],
"next_cursor": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB.",
"request_id": "req_example"
}
}{
"error": {
"code": "invalid_token",
"message": "The bearer token is missing or invalid.",
"request_id": "req_example"
}
}{
"error": {
"code": "forbidden",
"message": "Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required.",
"request_id": "req_example"
}
}{
"error": {
"code": "not_found",
"message": "The resource does not exist in the current organization.",
"request_id": "req_example"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Wait for the Retry-After delay before retrying.",
"request_id": "req_example"
}
}{
"error": {
"code": "internal_error",
"message": "Unexpected server failure. Include the request ID when contacting support.",
"request_id": "req_example"
}
}{
"error": {
"code": "service_unavailable",
"message": "Temporarily unavailable. Retry after the Retry-After delay, when provided.",
"request_id": "req_example"
}
}Authorizations
Headers
Query Parameters
Response
The approval rule.
What the rule approves: invoice, or purchase_order for orders made in Watchdog before they open, and amendments that raise their commitment or change their supplier, buyer, currency or commitment basis. Fixed once the rule is created.
invoice, purchase_order The fallback rule: who approves what no other rule of its subject gives approvers, at intake after the other rules, and when a waiting record loses its last approver. It has no conditions and matches every record, so a fallback for purchase orders makes every order made in Watchdog wait for approval. At most one per subject (WD-2930). Rules made as fallbacks before then may still have conditions and keep them.
Where the rule stands in the organization's order, lowest first. Under the approval policy's single_rule, an invoice takes its approvers from the first rule that matches it, in that rule's steps. Otherwise every matching rule adds its approvers by step number, and someone several rules name takes the step of the first.
x >= 0A saved View filter, returned as stored for unrestricted callers; it may be null or no longer valid. A restricted caller receives null with filter_restricted=true when the definition contains unavailable references or cannot be safely read. To replace it, send a filter in the shape the View create and update requests accept.