> ## Documentation Index
> Fetch the complete documentation index at: https://dub.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Approve a partner application
> Approve a pending partner application to your program. The partner will be enrolled in the specified group and notified of the approval.
Partners endpoints require an [Advanced plan](https://dub.co/pricing)
subscription or higher.
## OpenAPI
````yaml post /partners/applications/approve
openapi: 3.0.3
info:
title: Dub API
description: >-
Dub is the modern link attribution platform for short links, conversion
tracking, and affiliate programs.
version: 0.0.1
contact:
name: Dub Support
email: support@dub.co
url: https://dub.co/support
license:
name: AGPL-3.0 license
url: https://github.com/dubinc/dub/blob/main/LICENSE.md
servers:
- url: https://api.dub.co
description: Production API
security: []
paths:
/partners/applications/approve:
post:
tags:
- Partner Applications
summary: Approve a partner application
description: >-
Approve a pending partner application to your program. The partner will
be enrolled in the specified group and notified of the approval.
operationId: approvePartnerApplication
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
partnerId:
type: string
description: The ID of the partner to approve.
groupId:
description: >-
The ID of the group to assign the partner to. If not
provided, the partner will be assigned to the group they
applied to, or the program's default group if no application
group is set.
nullable: true
type: string
required:
- partnerId
responses:
'200':
description: The approved partner
content:
application/json:
schema:
type: object
properties:
partnerId:
type: string
description: The ID of the approved partner.
required:
- partnerId
additionalProperties: false
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'404':
$ref: '#/components/responses/404'
'409':
$ref: '#/components/responses/409'
'410':
$ref: '#/components/responses/410'
'422':
$ref: '#/components/responses/422'
'429':
$ref: '#/components/responses/429'
'500':
$ref: '#/components/responses/500'
security:
- token: []
x-codeSamples:
- lang: python
label: approvePartnerApplication
source: |-
from dub import Dub
with Dub(
token="DUB_API_KEY",
) as d_client:
res = d_client.partner_applications.approve(request={
"partner_id": "",
})
# Handle response
print(res)
- lang: php
label: approvePartnerApplication
source: |-
declare(strict_types=1);
require 'vendor/autoload.php';
use Dub;
use Dub\Models\Operations;
$sdk = Dub\Dub::builder()
->setSecurity(
'DUB_API_KEY'
)
->build();
$request = new Operations\ApprovePartnerApplicationRequestBody(
partnerId: '',
);
$response = $sdk->partnerApplications->approve(
request: $request
);
if ($response->object !== null) {
// handle response
}
- lang: go
label: approvePartnerApplication
source: "package main\n\nimport(\n\t\"context\"\n\tdubgo \"github.com/dubinc/dub-go\"\n\t\"github.com/dubinc/dub-go/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := dubgo.New(\n dubgo.WithSecurity(\"DUB_API_KEY\"),\n )\n\n res, err := s.PartnerApplications.Approve(ctx, operations.ApprovePartnerApplicationRequestBody{\n PartnerID: \"\",\n })\n if err != nil {\n log.Fatal(err)\n }\n if res != nil {\n // handle response\n }\n}"
- lang: ruby
label: approvePartnerApplication
source: |-
require 'dub'
Models = ::OpenApiSDK::Models
s = ::OpenApiSDK::Dub.new(
security: Models::Shared::Security.new(
token: 'DUB_API_KEY'
)
)
req = Models::Operations::ApprovePartnerApplicationRequestBody.new(
partner_id: ''
)
res = s.partner_applications.approve(request: req)
unless res.nil?
# handle response
end
- lang: typescript
label: approvePartnerApplication
source: |-
import { Dub } from "dub";
const dub = new Dub({
token: "DUB_API_KEY",
});
async function run() {
const result = await dub.partnerApplications.approve({
partnerId: "",
});
console.log(result);
}
run();
components:
responses:
'400':
description: >-
The server cannot or will not process the request due to something that
is perceived to be a client error (e.g., malformed request syntax,
invalid request message framing, or deceptive request routing).
content:
application/json:
schema:
x-speakeasy-name-override: BadRequest
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- bad_request
description: A short code indicating the error code returned.
example: bad_request
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: https://dub.co/docs/api-reference/errors#bad-request
required:
- code
- message
required:
- error
'401':
description: >-
Although the HTTP standard specifies "unauthorized", semantically this
response means "unauthenticated". That is, the client must authenticate
itself to get the requested response.
content:
application/json:
schema:
x-speakeasy-name-override: Unauthorized
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- unauthorized
description: A short code indicating the error code returned.
example: unauthorized
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: https://dub.co/docs/api-reference/errors#unauthorized
required:
- code
- message
required:
- error
'403':
description: >-
The client does not have access rights to the content; that is, it is
unauthorized, so the server is refusing to give the requested resource.
Unlike 401 Unauthorized, the client's identity is known to the server.
content:
application/json:
schema:
x-speakeasy-name-override: Forbidden
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- forbidden
description: A short code indicating the error code returned.
example: forbidden
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: https://dub.co/docs/api-reference/errors#forbidden
required:
- code
- message
required:
- error
'404':
description: The server cannot find the requested resource.
content:
application/json:
schema:
x-speakeasy-name-override: NotFound
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- not_found
description: A short code indicating the error code returned.
example: not_found
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: https://dub.co/docs/api-reference/errors#not-found
required:
- code
- message
required:
- error
'409':
description: >-
This response is sent when a request conflicts with the current state of
the server.
content:
application/json:
schema:
x-speakeasy-name-override: Conflict
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- conflict
description: A short code indicating the error code returned.
example: conflict
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: https://dub.co/docs/api-reference/errors#conflict
required:
- code
- message
required:
- error
'410':
description: >-
This response is sent when the requested content has been permanently
deleted from server, with no forwarding address.
content:
application/json:
schema:
x-speakeasy-name-override: InviteExpired
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- invite_expired
description: A short code indicating the error code returned.
example: invite_expired
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: https://dub.co/docs/api-reference/errors#invite-expired
required:
- code
- message
required:
- error
'422':
description: >-
The request was well-formed but was unable to be followed due to
semantic errors.
content:
application/json:
schema:
x-speakeasy-name-override: UnprocessableEntity
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- unprocessable_entity
description: A short code indicating the error code returned.
example: unprocessable_entity
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: >-
https://dub.co/docs/api-reference/errors#unprocessable-entity
required:
- code
- message
required:
- error
'429':
description: >-
The user has sent too many requests in a given amount of time ("rate
limiting")
content:
application/json:
schema:
x-speakeasy-name-override: RateLimitExceeded
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- rate_limit_exceeded
description: A short code indicating the error code returned.
example: rate_limit_exceeded
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: >-
https://dub.co/docs/api-reference/errors#rate-limit_exceeded
required:
- code
- message
required:
- error
'500':
description: The server has encountered a situation it does not know how to handle.
content:
application/json:
schema:
x-speakeasy-name-override: InternalServerError
type: object
properties:
error:
type: object
properties:
code:
type: string
enum:
- internal_server_error
description: A short code indicating the error code returned.
example: internal_server_error
message:
x-speakeasy-error-message: true
type: string
description: A human readable explanation of what went wrong.
example: The requested resource was not found.
doc_url:
type: string
description: >-
A link to our documentation with more details about this
error code
example: >-
https://dub.co/docs/api-reference/errors#internal-server_error
required:
- code
- message
required:
- error
securitySchemes:
token:
type: http
description: Default authentication mechanism
scheme: bearer
x-speakeasy-example: DUB_API_KEY
````