> **Shapeless capabilities index**
> Fetch https://shapelessai.com/llms.txt to discover every page before exploring further.
> Every page also answers Markdown: append `.md` to its path, or send `Accept: text/markdown`.

# Audit a profile

*Verified 2026-10-07. Source: https://shapelessai.com/capabilities/profile-audit*

Grade a connected profile the way a visitor reads it (name, bio, picture, banner, links, pinned post) and get the fix list, each item with ready-to-paste copy.

Read every audit or one account's, run a fresh one, and mark an item done or dismissed as the person works through it. The audit is what to fix before spending on reach.

## Ask in plain words

- "audit my LinkedIn profile"
- "what should I fix on my X bio"
- "rewrite my Instagram bio from the audit"

## From an agent host (MCP)

No MCP tool yet: call the REST routes below.

## From code (REST)

Bearer API key with the scope each call names ([auth](https://shapelessai.com/docs/auth), [OpenAPI](https://shapelessai.com/api/openapi.json)).

- `GET /api/profile/audits` (read scope): Latest profile score and open fix count per connected account.
- `GET /api/profile/audits/{connectionId}` (read scope): One account's fix list with ready-to-paste copy, and its last two scores.
- `POST /api/profile/audits/{connectionId}` (write scope): Read the live profile and grade it again (spends credits).
- `PATCH /api/profile/audit-items/{id}` (write scope): Resolve one fix: {status: todo|done|dismissed}.

## From a terminal (CLI)

No CLI command yet.

## Example

```bash
curl -s https://shapelessai.com/api/profile/audits/<connectionId> -X POST -H "Authorization: Bearer $SHAPELESS_API_KEY"
```

## Refusals

| Status | Meaning |
| --- | --- |
| 429 | Too many runs. |

## Where else

- [Do it in the studio](https://shapelessai.com/studio/accounts)