# Athenian settings API

**Canonical:** https://apis.io/apis/athenian/athenian-settings-api/  
**Provider:** Athenian — https://apis.io/providers/athenian/  
**Base URL:** https://api.athenian.co/v1  
**Documentation:** https://github.com/athenianco/api-spec

Athenian settings API is one of 15 APIs that [Athenian](https://apis.io/providers/athenian/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Settings. The published artifact set on APIs.io includes an OpenAPI specification.

The settings API from Athenian — 13 operation(s) for settings.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| PATCH | `/settings/jira/identities` | 👤 Add, remove or override GitHub<>JIRA user identity mapping. |
| GET | `/settings/jira/identities/{id}` | Fetch the GitHub<>JIRA user identity mapping. |
| PUT | `/settings/jira/projects` | 🛡️👤 Set the enabled JIRA projects. |
| GET | `/settings/jira/projects/{id}` | List the currently enabled JIRA project settings. |
| GET | `/settings/logical_repositories/{id}` | List the currently configured logical repositories. A logical repository is a set of rules to match PRs, releases, and deployments that has a name and preten... |
| PUT | `/settings/logical_repository` | 🛡️👤 Insert or update a logical repository - a named set of rules to match PRs, releases, and deployments that pretends to be a regular GitHub repository ever... |
| POST | `/settings/logical_repository/delete` | 🛡️ Delete a logical repository. |
| PUT | `/settings/release_match` | 👤 Set the release matching rule for a list of repositories. Only for account admins. Release settings are rules by which to mark releases in GitHub repositor... |
| GET | `/settings/release_match/{id}` | List the current release matching settings. Release settings are rules by which to mark releases in GitHub repositories. |
| PUT | `/settings/work_type` | 👤 Create or update a work type - a rule set to group PRs, releases, etc. together. |
| POST | `/settings/work_type/delete` | 👤 Remove the work type given the name. |
| POST | `/settings/work_type/get` | Fetch the definition of the work type given the name. |
| GET | `/settings/work_types/{id}` | List the current work types - rule sets to group PRs, releases, etc. together. |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/athenian/refs/heads/main/openapi/athenian-settings-api-openapi.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/athenian/refs/heads/main/errors/athenian-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/athenian/refs/heads/main/conventions/athenian-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/athenian/refs/heads/main/data-model/athenian-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/athenian/refs/heads/main/conformance/athenian-conformance.yml

## Other Athenian APIs (12)

- [Athenian align API](https://apis.io/apis/athenian/athenian-align-api/)
- [Athenian events API](https://apis.io/apis/athenian/athenian-events-api/)
- [Athenian filter API](https://apis.io/apis/athenian/athenian-filter-api/)
- [Athenian get API](https://apis.io/apis/athenian/athenian-get-api/)
- [Athenian histograms API](https://apis.io/apis/athenian/athenian-histograms-api/)
- [Athenian integrations API](https://apis.io/apis/athenian/athenian-integrations-api/)
- [Athenian metrics API](https://apis.io/apis/athenian/athenian-metrics-api/)
- [Athenian pagination API](https://apis.io/apis/athenian/athenian-pagination-api/)
- [Athenian registration API](https://apis.io/apis/athenian/athenian-registration-api/)
- [Athenian reposet API](https://apis.io/apis/athenian/athenian-reposet-api/)
- [Athenian security API](https://apis.io/apis/athenian/athenian-security-api/)
- [Athenian team API](https://apis.io/apis/athenian/athenian-team-api/)

## Tags

Settings

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/athenian/athenian-settings-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/athenian/.