---
title: "Complete onboarding step"
method: POST
path: "/api/onboarding/step"
tags: ["v1", "onboarding"]
---

# Complete onboarding step

`POST /api/onboarding/step`

## Query parameters

- `step` 'WELCOME' | 'USAGE_REASON' | 'INTEGRATIONS' | 'AGENT_CHOICE' | 'AGENT_NEW_RUN' | 'AGENT_INPUT' | 'CONGRATS' | 'ONBOARDING_COMPLETE' | 'BUILDER_OPEN' | 'CAPABILITY_CARDS' | 'AGENTS_TAB_INTRO' | 'MARKETPLACE_TAB_INTRO' | 'BUILD_TAB_INTRO', required

## Response `200`

Successful Response

- unknown

## Other responses

- `401` — Authentication required
- `422` — Validation Error

## Changes

- **2026-08-10** `c5d87f954859` — 3 info
  - added the new enum value `AGENTS_TAB_INTRO` to the `query` request parameter `step`
  - added the new enum value `BUILD_TAB_INTRO` to the `query` request parameter `step`
  - added the new enum value `MARKETPLACE_TAB_INTRO` to the `query` request parameter `step`
- **2026-08-07** `c81533fee655` — 1 breaking, 1 info
  - removed the enum value `VISIT_COPILOT` from the `query` request parameter `step`
  - added the new enum value `ONBOARDING_COMPLETE` to the `query` request parameter `step`
- **2026-08-05** `382041c7ecb2` — 1 info
  - added the new enum value `CAPABILITY_CARDS` to the `query` request parameter `step`
- **2026-05-01** `772563af864e` — 1 breaking
  - removed the enum value `MARKETPLACE_VISIT` from the `query` request parameter `step`
- **2026-04-30** `8c84efcb3afb` — 1 info
  - added the new enum value `MARKETPLACE_VISIT` to the `query` request parameter `step`

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/onboarding/step/post.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/5dc375899754/schema)