---
since: 0.6.0
---

# API Resources

A generic issue-tracking API normally exposes the following resource model.

```text
Project
  │
  ├── Project members
  │
  └── Issues
        │
        ├── status
        ├── priority
        ├── assignee
        ├── reporter
        ├── labels
        ├── comments
        └── attachments
```

## Project

Represents the workspace/container in which issues are managed.

Typical operations:

```text
create
retrieve
update
list
archive/delete
```

## Issue

Represents an actionable work item.

Typical operations:

```text
create
retrieve
update
list
assign
change status
change priority
comment
```

## Comments

Comments belong to an issue and provide an auditable discussion trail.

## Membership

Membership controls which users can access a project and which project-level
actions they can perform.