Policies API
You may want to programmatically access your company's policies, rather than reading them manually from your Policy Dashboard. You can fetch your policies through our Policies API.
Fetching Your Policies
To send a request to the Policies API, you can simply send a GET
HTTP request to https://getcove.com/api/v1/policies
with your API Key in the request header.
Example Response
Here is an example response:
{
policies: [
{
id: 'abc123',
name: 'Hate Speech',
parentId: null
},
{
id: 'def456',
name: 'Transphobia',
parentId: 'abc123'
},
{
id: 'ghi789',
name: 'Spam',
parentId: null
}
]
}
The response will contain one top-level property called policies
, which will be an array that contains all of your company's policies. Each policy will have the following shape:
Property | Type | Description |
---|---|---|
id | String | Our unique identifier for this policy |
name | String | The name that you assigned to this policy. |
parentId | String or null | Policies are structured as a tree, so policies can have children (which we call "sub-policies") and/or a parent. For example, if you create a Violence policy, you might also create sub-policies under that policy called Graphic Violence , Threats , Celebration of Violence , etc. In this case, Violence is the "parent" of those three sub-policies.We use the parentId field to let you know what the parent of this policy is, if it has one. That way, you can see the entire policy tree structure. |
Note: We strongly recommend that you avoid building any critical logic into your code that relies on policy names staying the same. Anyone with access to your company's Cove instance can change policy names at any time. Instead, we recommend using policy IDs, which are immutable.
Updated 4 months ago