---
title: "POST /outposts/instances/"
method: POST
path: "/outposts/instances/"
tags: ["outposts"]
---

# POST /outposts/instances/

`POST /outposts/instances/`

Outpost Viewset

## Request body

- OutpostRequest — Outpost Serializer
  - `name` string, required
  - `type` 'proxy' | 'ldap' | 'radius' | 'rac', required
  - `providers` integer[], required
  - `service_connection` string, uuid, nullable — Select Service-Connection authentik should use to manage this outpost. Leave empty if authentik should not handle the deployment.
  - `config` object, required
  - `managed` string, nullable — Objects that are managed by authentik. These objects are created and updated automatically. This flag only indicates that an object can be overwritten by migrations. You can still modify the objects via the API, but expect changes to be overwritten in a later update.

## Response `201`

- Outpost — Outpost Serializer
  - `pk` string, uuid, required
  - `name` string, required
  - `type` 'proxy' | 'ldap' | 'radius' | 'rac', required
  - `providers` integer[], required
  - `providers_obj` Provider[], required
    - `pk` integer, required
    - `name` string, required
    - `authentication_flow` string, uuid, nullable — Flow used for authentication when the associated application is accessed by an un-authenticated user.
    - `authorization_flow` string, uuid, nullable — Flow used when authorizing this provider.
    - `invalidation_flow` string, uuid, nullable — Flow used ending the session from a provider.
    - `property_mappings` string[]
    - `component` string, required — Get object component so that we know how to edit the object
    - `assigned_application_slug` string, nullable, required — Internal application name, used in URLs.
    - `assigned_application_name` string, nullable, required — Application's display Name.
    - `assigned_backchannel_application_slug` string, nullable, required — Internal application name, used in URLs.
    - `assigned_backchannel_application_name` string, nullable, required — Application's display Name.
    - `verbose_name` string, required — Return object's verbose_name
    - `verbose_name_plural` string, required — Return object's plural verbose_name
    - `meta_model_name` string, required — Return internal model name
  - `service_connection` string, uuid, nullable — Select Service-Connection authentik should use to manage this outpost. Leave empty if authentik should not handle the deployment.
  - `service_connection_obj` ServiceConnection, required — ServiceConnection Serializer
    - `pk` string, uuid, required
    - `name` string, required
    - `local` boolean — If enabled, use the local connection. Required Docker socket/Kubernetes Integration
    - `component` string, required — Return component used to edit this object
    - `verbose_name` string, required — Return object's verbose_name
    - `verbose_name_plural` string, required — Return object's plural verbose_name
    - `meta_model_name` string, required — Return internal model name
  - `refresh_interval_s` integer, required
  - `token_identifier` string, required — Get Token identifier
  - `config` object, required
  - `managed` string, nullable — Objects that are managed by authentik. These objects are created and updated automatically. This flag only indicates that an object can be overwritten by migrations. You can still modify the objects via the API, but expect changes to be overwritten in a later update.

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)