Skip to content

`GET /v1/orgs/{org}/policies`.

GET
/v1/orgs/{org}/policies
curl --request GET \
--url https://api.updawg.net/v1/orgs/example/policies
org
required
string

Organization slug.

Every live policy. ⚠️ Without its YAML — a page showing forty policies does not render forty documents.

Media typeapplication/json
Array<object>
object
created_at
required
string format: date-time
enabled
required
boolean
id
required
string
managed_by
One of:

⚠️ terraform: the Terraform provider created or last saved this policy, and its next terraform apply puts its own text back over any other edit. Recorded from the provider’s requests and never cleared by an edit from anywhere else. null is a policy no tool claims.

string
Allowed values: terraform
name
required
string
priority
required
integer format: int32
updated_at
required
string format: date-time
version
required

Which version is in force. Named version rather than current_version because from outside there is only one that matters, and ?version= takes this same number.

integer format: int32

Example

[
{
"managed_by": "terraform"
}
]

No session.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

No such organization, or not yours.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

The organization’s data is in another region (wrong-region, DAWG-159). detail names that region’s API; send the request there.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}

Over the organization’s request limit. Retry-After says when to try again; RateLimit-Limit is the burst.

Media typeapplication/json
object
detail
string | null
status
required
integer format: int32
title
required
string
type
required
string

Example generated

{
"detail": "example",
"status": 1,
"title": "example",
"type": "example"
}