---
title: "Start an authenticated GEO audit job"
method: POST
path: "/api/dashboard/geo"
---

# Start an authenticated GEO audit job

`POST /api/dashboard/geo`

## Request

- Base URL: `https://genvernium.com`
- URL: `https://genvernium.com/api/dashboard/geo`
- Auth: HTTP cookie

Starts a durable, approval-scoped GEO audit and returns a job identifier and status for polling.

## Query parameters

- `workspaceId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `kind` 'crawl' | 'audit', required

## Response `202`

The GEO audit was accepted for asynchronous processing.

- GeoJobAccepted
  - `id` string, uuid, required
  - `status` string, required

## Other responses

- `400`: The request was invalid.
- `401`: Authentication is required.
- `404`: The requested public resource was not found.
- `406`: The requested representation is not supported.
- `409`: The request conflicts with current workspace state.
- `422`: The request could not be processed.
- `429`: The request was rate limited.
- `500`: The service could not complete the request.

---

[API](https://skmtc.dev/genvernium/apis/genvernium-public-discovery-api.md) · [All operations](https://skmtc.dev/genvernium/apis/genvernium-public-discovery-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genvernium/apis/genvernium-public-discovery-api/revisions/6375bbb40acf?raw)