> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nokia.atlas.arenaphysica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Generating an Issue

> Create and track a structured finding.

<Frame>
  <img src="https://mintcdn.com/nova-arena-ai/QLYGKsZPO6EMCCJF/issue-details.png?fit=max&auto=format&n=QLYGKsZPO6EMCCJF&q=85&s=bfbb22d9341153c153987de6f519d327" alt="Issue details view" width="3094" height="1756" data-path="issue-details.png" />
</Frame>

## 1. Create an issue

```bash theme={null}
curl -X POST "https://nokia.atlas.arenaphysica.com/api/v1/issues" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Power rail undervoltage at startup",
    "status": "open",
    "priority": "high",
    "tags": ["power", "startup"]
  }'
```

Save the `uuid` from the response:

```bash theme={null}
export ISSUE_ID="<uuid from response>"
```

**Field reference:**

| Field      | Values                                        |
| ---------- | --------------------------------------------- |
| `status`   | `open`, `in_progress`, `resolved`, `rejected` |
| `priority` | `low`, `medium`, `high`                       |
| `tags`     | Any list of strings                           |

## 2. Update the issue

Use `PATCH` to update any field:

```bash theme={null}
curl -X PATCH "https://nokia.atlas.arenaphysica.com/api/v1/issues/$ISSUE_ID" \
  -H "Authorization: Bearer $ATLAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status": "in_progress"}'
```

## 3. Fetch the issue

```bash theme={null}
curl "https://nokia.atlas.arenaphysica.com/api/v1/issues/$ISSUE_ID" \
  -H "Authorization: Bearer $ATLAS_TOKEN"
```