@tolt/api 1.2.0 → 1.4.0

package/dist/api/resources/partnerTags/client/requests/GetPartnerTagRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         id: "ptag_zDEcdqNuNBPcokarWxBnk9gB"
+ *     }
+ */
+export interface GetPartnerTagRequest {
+    id: string;
+}

package/dist/api/resources/partnerTags/client/requests/GetPartnerTagRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/client/requests/ListPartnerTagsRequest.d.ts

@@ -0,0 +1,29 @@
+import type * as ToltApi from "../../../../index.js";
+/**
+ * @example
+ *     {}
+ */
+export interface ListPartnerTagsRequest {
+    /** How many rows to return in one page. */
+    limit?: number;
+    /** Ranking direction: desc puts the most recently created or updated rows first. */
+    order?: ToltApi.ListPartnerTagsRequestOrder;
+    /** Timestamp to order and page by: created_at follows creation order, updated_at follows each item's most recent change. */
+    sort?: ToltApi.ListPartnerTagsRequestSort;
+    /** Continue after a position: the next_cursor of a previous page, or an item id when sorting by created_at. Cannot be combined with ending_before. */
+    starting_after?: string;
+    /** Page backward from a position: the prev_cursor of a previous page, or an item id when sorting by created_at. Cannot be combined with starting_after. */
+    ending_before?: string;
+    /** Start of a window on when items were created: items created at this time or later are included, for example 2026-01-01T00:00:00Z. Leave it out for no lower bound. */
+    created_after?: string;
+    /** End of a window on when items were created: only items created before this time are included. Leave it out for no upper bound. */
+    created_before?: string;
+    /** Only items last changed at or after this moment; with sort=updated_at, use it to fetch what changed since a previous sync. */
+    updated_after?: string;
+    /** Only items last changed before this moment; pair it with updated_after to fetch what changed in a period. */
+    updated_before?: string;
+    /** Limit to one program, by its id (prg_...) as returned when listing programs. */
+    program_id?: string;
+    /** Text matched anywhere in the tag name, ignoring case. */
+    search?: string;
+}

package/dist/api/resources/partnerTags/client/requests/ListPartnerTagsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/client/requests/UpdatePartnerTagRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @example
+ *     {
+ *         id: "ptag_zDEcdqNuNBPcokarWxBnk9gB",
+ *         name: "VIP",
+ *         color: "#2457D6"
+ *     }
+ */
+export interface UpdatePartnerTagRequest {
+    id: string;
+    /** Label shown on the partner in the dashboard, up to 50 characters. A program cannot have two tags with the same name, ignoring case. */
+    name?: string;
+    /** Color of the tag in the dashboard, as a hex code like #2457D6. */
+    color?: string;
+}

package/dist/api/resources/partnerTags/client/requests/UpdatePartnerTagRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/client/requests/index.d.ts

@@ -0,0 +1,5 @@
+export type { CreatePartnerTagRequest } from "./CreatePartnerTagRequest.js";
+export type { DeletePartnerTagRequest } from "./DeletePartnerTagRequest.js";
+export type { GetPartnerTagRequest } from "./GetPartnerTagRequest.js";
+export type { ListPartnerTagsRequest } from "./ListPartnerTagsRequest.js";
+export type { UpdatePartnerTagRequest } from "./UpdatePartnerTagRequest.js";

package/dist/api/resources/partnerTags/client/requests/index.js

@@ -0,0 +1 @@
+export {};

package/dist/api/resources/partnerTags/exports.d.ts

@@ -0,0 +1,2 @@
+export { PartnerTagsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/partnerTags/exports.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { PartnerTagsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/api/resources/partnerTags/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/api/resources/partnerTags/index.js

@@ -0,0 +1,2 @@
+export * from "./client/index.js";
+export * from "./types/index.js";

package/dist/api/resources/partnerTags/types/CreatePartnerTagResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as ToltApi from "../../../index.js";
+export interface CreatePartnerTagResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTag;
+}

package/dist/api/resources/partnerTags/types/CreatePartnerTagResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/types/DeletePartnerTagResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as ToltApi from "../../../index.js";
+export interface DeletePartnerTagResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTag;
+}

package/dist/api/resources/partnerTags/types/DeletePartnerTagResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/types/GetPartnerTagResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as ToltApi from "../../../index.js";
+export interface GetPartnerTagResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTag;
+}

package/dist/api/resources/partnerTags/types/GetPartnerTagResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/types/ListPartnerTagsRequestOrder.d.ts

@@ -0,0 +1,6 @@
+/** Ranking direction: desc puts the most recently created or updated rows first. */
+export declare const ListPartnerTagsRequestOrder: {
+    readonly Asc: "asc";
+    readonly Desc: "desc";
+};
+export type ListPartnerTagsRequestOrder = (typeof ListPartnerTagsRequestOrder)[keyof typeof ListPartnerTagsRequestOrder];

package/dist/api/resources/partnerTags/types/ListPartnerTagsRequestOrder.js

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Ranking direction: desc puts the most recently created or updated rows first. */
+export const ListPartnerTagsRequestOrder = {
+    Asc: "asc",
+    Desc: "desc",
+};

package/dist/api/resources/partnerTags/types/ListPartnerTagsRequestSort.d.ts

@@ -0,0 +1,6 @@
+/** Timestamp to order and page by: created_at follows creation order, updated_at follows each item's most recent change. */
+export declare const ListPartnerTagsRequestSort: {
+    readonly CreatedAt: "created_at";
+    readonly UpdatedAt: "updated_at";
+};
+export type ListPartnerTagsRequestSort = (typeof ListPartnerTagsRequestSort)[keyof typeof ListPartnerTagsRequestSort];

package/dist/api/resources/partnerTags/types/ListPartnerTagsRequestSort.js

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Timestamp to order and page by: created_at follows creation order, updated_at follows each item's most recent change. */
+export const ListPartnerTagsRequestSort = {
+    CreatedAt: "created_at",
+    UpdatedAt: "updated_at",
+};

package/dist/api/resources/partnerTags/types/ListPartnerTagsResponse.d.ts

@@ -0,0 +1,11 @@
+import type * as ToltApi from "../../../index.js";
+export interface ListPartnerTagsResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTag[];
+    has_more: boolean;
+    /** Opaque cursor marking the last item on this page. Pass it as starting_after to continue. Null when the page is empty. */
+    next_cursor: string | null;
+    /** Opaque cursor marking the first item on this page. Pass it as ending_before to page backward. Null when the page is empty. */
+    prev_cursor: string | null;
+}

package/dist/api/resources/partnerTags/types/ListPartnerTagsResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/types/UpdatePartnerTagResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as ToltApi from "../../../index.js";
+export interface UpdatePartnerTagResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTag;
+}

package/dist/api/resources/partnerTags/types/UpdatePartnerTagResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partnerTags/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./CreatePartnerTagResponse.js";
+export * from "./DeletePartnerTagResponse.js";
+export * from "./GetPartnerTagResponse.js";
+export * from "./ListPartnerTagsRequestOrder.js";
+export * from "./ListPartnerTagsRequestSort.js";
+export * from "./ListPartnerTagsResponse.js";
+export * from "./UpdatePartnerTagResponse.js";

package/dist/api/resources/partnerTags/types/index.js

@@ -0,0 +1,7 @@
+export * from "./CreatePartnerTagResponse.js";
+export * from "./DeletePartnerTagResponse.js";
+export * from "./GetPartnerTagResponse.js";
+export * from "./ListPartnerTagsRequestOrder.js";
+export * from "./ListPartnerTagsRequestSort.js";
+export * from "./ListPartnerTagsResponse.js";
+export * from "./UpdatePartnerTagResponse.js";

package/dist/api/resources/partners/client/Client.d.ts

@@ -52,7 +52,7 @@ export declare class PartnersClient {
     bulkReject(request: ToltApi.BulkRejectPartnersRequest, requestOptions?: PartnersClient.RequestOptions): core.HttpResponsePromise<ToltApi.BulkRejectPartnersResponse>;
     private __bulkReject;
     /**
-     * Lists onboarded partners. Filter by status, program or group, search by name, email or company, and page with cursors.
+     * Lists onboarded partners. Filter by status, program, group or external_id, search by name, email or company, and page with cursors.
      *
      * @param {ToltApi.ListPartnersRequest} request
      * @param {PartnersClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -86,6 +86,7 @@ export declare class PartnersClient {
      *     await client.partners.create({
      *         email: "sam@example.com",
      *         program_id: "prg_T6z8aRW3XCmvFWP972RKxpAd",
+     *         external_id: "user_123",
      *         first_name: "Sam",
      *         last_name: "Taylor",
      *         group_id: "grp_zUQ8Pt281MsbNDApmDPN3Y2a",
@@ -126,6 +127,7 @@ export declare class PartnersClient {
      * @throws {@link ToltApi.BadRequestError}
      * @throws {@link ToltApi.UnauthorizedError}
      * @throws {@link ToltApi.NotFoundError}
+     * @throws {@link ToltApi.ConflictError}
      * @throws {@link ToltApi.ContentTooLargeError}
      * @throws {@link ToltApi.TooManyRequestsError}
      * @throws {@link errors.ToltApiError}
@@ -203,4 +205,47 @@ export declare class PartnersClient {
      */
     suspend(request: ToltApi.SuspendPartnerRequest, requestOptions?: PartnersClient.RequestOptions): core.HttpResponsePromise<ToltApi.SuspendPartnerResponse>;
     private __suspend;
+    /**
+     * Puts one or more tags on the partner. Each tag must belong to the partner's program; tags the partner already has stay as they are. Returns every tag the partner now has, and sends partner.updated if any tag was added.
+     *
+     * @param {ToltApi.AddPartnerTagsRequest} request
+     * @param {PartnersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ToltApi.BadRequestError}
+     * @throws {@link ToltApi.UnauthorizedError}
+     * @throws {@link ToltApi.NotFoundError}
+     * @throws {@link ToltApi.ContentTooLargeError}
+     * @throws {@link ToltApi.TooManyRequestsError}
+     * @throws {@link errors.ToltApiError}
+     * @throws {@link errors.ToltApiTimeoutError}
+     *
+     * @example
+     *     await client.partners.addPartnerTags({
+     *         id: "part_NLYzgNKuSuASvrvoxNtau6SY",
+     *         tag_ids: ["ptag_zDEcdqNuNBPcokarWxBnk9gB"]
+     *     })
+     */
+    addPartnerTags(request: ToltApi.AddPartnerTagsRequest, requestOptions?: PartnersClient.RequestOptions): core.HttpResponsePromise<ToltApi.AddPartnerTagsResponse>;
+    private __addPartnerTags;
+    /**
+     * Takes the tag off the partner. Removing a tag the partner does not have succeeds and changes nothing. Returns every tag the partner still has, and sends partner.updated if the tag was removed.
+     *
+     * @param {ToltApi.RemovePartnerTagRequest} request
+     * @param {PartnersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ToltApi.UnauthorizedError}
+     * @throws {@link ToltApi.NotFoundError}
+     * @throws {@link ToltApi.ContentTooLargeError}
+     * @throws {@link ToltApi.TooManyRequestsError}
+     * @throws {@link errors.ToltApiError}
+     * @throws {@link errors.ToltApiTimeoutError}
+     *
+     * @example
+     *     await client.partners.removePartnerTag({
+     *         id: "part_NLYzgNKuSuASvrvoxNtau6SY",
+     *         tag_id: "ptag_zDEcdqNuNBPcokarWxBnk9gB"
+     *     })
+     */
+    removePartnerTag(request: ToltApi.RemovePartnerTagRequest, requestOptions?: PartnersClient.RequestOptions): core.HttpResponsePromise<ToltApi.RemovePartnerTagResponse>;
+    private __removePartnerTag;
 }

package/dist/api/resources/partners/client/Client.js

@@ -139,7 +139,7 @@ export class PartnersClient {
         return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v2/partners/bulk/reject");
     }
     /**
-     * Lists onboarded partners. Filter by status, program or group, search by name, email or company, and page with cursors.
+     * Lists onboarded partners. Filter by status, program, group or external_id, search by name, email or company, and page with cursors.
      *
      * @param {ToltApi.ListPartnersRequest} request
      * @param {PartnersClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -156,7 +156,7 @@ export class PartnersClient {
      */
     async list(request = {}, requestOptions) {
         const list = core.HttpResponsePromise.interceptFunction(async (request) => {
-            const { limit, order, sort, starting_after: startingAfter, ending_before: endingBefore, created_after: createdAfter, created_before: createdBefore, updated_after: updatedAfter, updated_before: updatedBefore, status, program_id: programId, group_id: groupId, search, } = request;
+            const { limit, order, sort, starting_after: startingAfter, ending_before: endingBefore, created_after: createdAfter, created_before: createdBefore, updated_after: updatedAfter, updated_before: updatedBefore, status, program_id: programId, group_id: groupId, tag_id: tagId, external_id: externalId, search, } = request;
             const _queryParams = {
                 limit,
                 order: order != null ? order : undefined,
@@ -170,6 +170,8 @@ export class PartnersClient {
                 status: status != null ? status : undefined,
                 program_id: programId,
                 group_id: groupId,
+                tag_id: tagId,
+                external_id: externalId,
                 search,
             };
             const _authRequest = await this._options.authProvider.getAuthRequest();
@@ -244,6 +246,7 @@ export class PartnersClient {
      *     await client.partners.create({
      *         email: "sam@example.com",
      *         program_id: "prg_T6z8aRW3XCmvFWP972RKxpAd",
+     *         external_id: "user_123",
      *         first_name: "Sam",
      *         last_name: "Taylor",
      *         group_id: "grp_zUQ8Pt281MsbNDApmDPN3Y2a",
@@ -370,6 +373,7 @@ export class PartnersClient {
      * @throws {@link ToltApi.BadRequestError}
      * @throws {@link ToltApi.UnauthorizedError}
      * @throws {@link ToltApi.NotFoundError}
+     * @throws {@link ToltApi.ConflictError}
      * @throws {@link ToltApi.ContentTooLargeError}
      * @throws {@link ToltApi.TooManyRequestsError}
      * @throws {@link errors.ToltApiError}
@@ -417,6 +421,8 @@ export class PartnersClient {
                     throw new ToltApi.UnauthorizedError(_response.error.body, _response.rawResponse);
                 case 404:
                     throw new ToltApi.NotFoundError(_response.error.body, _response.rawResponse);
+                case 409:
+                    throw new ToltApi.ConflictError(_response.error.body, _response.rawResponse);
                 case 413:
                     throw new ToltApi.ContentTooLargeError(_response.error.body, _response.rawResponse);
                 case 429:
@@ -626,4 +632,134 @@ export class PartnersClient {
         }
         return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v2/partners/{id}/suspend");
     }
+    /**
+     * Puts one or more tags on the partner. Each tag must belong to the partner's program; tags the partner already has stay as they are. Returns every tag the partner now has, and sends partner.updated if any tag was added.
+     *
+     * @param {ToltApi.AddPartnerTagsRequest} request
+     * @param {PartnersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ToltApi.BadRequestError}
+     * @throws {@link ToltApi.UnauthorizedError}
+     * @throws {@link ToltApi.NotFoundError}
+     * @throws {@link ToltApi.ContentTooLargeError}
+     * @throws {@link ToltApi.TooManyRequestsError}
+     * @throws {@link errors.ToltApiError}
+     * @throws {@link errors.ToltApiTimeoutError}
+     *
+     * @example
+     *     await client.partners.addPartnerTags({
+     *         id: "part_NLYzgNKuSuASvrvoxNtau6SY",
+     *         tag_ids: ["ptag_zDEcdqNuNBPcokarWxBnk9gB"]
+     *     })
+     */
+    addPartnerTags(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__addPartnerTags(request, requestOptions));
+    }
+    async __addPartnerTags(request, requestOptions) {
+        const { id, ..._body } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.ToltApiEnvironment.Default, `v2/partners/${core.url.encodePathParam(id, errors.ToltApiError)}/tags`),
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            requestType: "json",
+            body: mergeAdditionalBodyParameters(_body, requestOptions?.additionalBodyParameters),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new ToltApi.BadRequestError(_response.error.body, _response.rawResponse);
+                case 401:
+                    throw new ToltApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new ToltApi.NotFoundError(_response.error.body, _response.rawResponse);
+                case 413:
+                    throw new ToltApi.ContentTooLargeError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new ToltApi.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.ToltApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v2/partners/{id}/tags");
+    }
+    /**
+     * Takes the tag off the partner. Removing a tag the partner does not have succeeds and changes nothing. Returns every tag the partner still has, and sends partner.updated if the tag was removed.
+     *
+     * @param {ToltApi.RemovePartnerTagRequest} request
+     * @param {PartnersClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link ToltApi.UnauthorizedError}
+     * @throws {@link ToltApi.NotFoundError}
+     * @throws {@link ToltApi.ContentTooLargeError}
+     * @throws {@link ToltApi.TooManyRequestsError}
+     * @throws {@link errors.ToltApiError}
+     * @throws {@link errors.ToltApiTimeoutError}
+     *
+     * @example
+     *     await client.partners.removePartnerTag({
+     *         id: "part_NLYzgNKuSuASvrvoxNtau6SY",
+     *         tag_id: "ptag_zDEcdqNuNBPcokarWxBnk9gB"
+     *     })
+     */
+    removePartnerTag(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__removePartnerTag(request, requestOptions));
+    }
+    async __removePartnerTag(request, requestOptions) {
+        const { id, tag_id: tagId } = request;
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.ToltApiEnvironment.Default, `v2/partners/${core.url.encodePathParam(id, errors.ToltApiError)}/tags/${core.url.encodePathParam(tagId, errors.ToltApiError)}`),
+            method: "DELETE",
+            headers: _headers,
+            queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 401:
+                    throw new ToltApi.UnauthorizedError(_response.error.body, _response.rawResponse);
+                case 404:
+                    throw new ToltApi.NotFoundError(_response.error.body, _response.rawResponse);
+                case 413:
+                    throw new ToltApi.ContentTooLargeError(_response.error.body, _response.rawResponse);
+                case 429:
+                    throw new ToltApi.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                default:
+                    throw new errors.ToltApiError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/v2/partners/{id}/tags/{tag_id}");
+    }
 }

package/dist/api/resources/partners/client/requests/AddPartnerTagsRequest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @example
+ *     {
+ *         id: "part_NLYzgNKuSuASvrvoxNtau6SY",
+ *         tag_ids: ["ptag_zDEcdqNuNBPcokarWxBnk9gB"]
+ *     }
+ */
+export interface AddPartnerTagsRequest {
+    id: string;
+    /** Ids of the tags to add (ptag_...), as returned when listing partner tags. Each must belong to the partner's program. Tags the partner already has stay as they are. */
+    tag_ids: string[];
+}

package/dist/api/resources/partners/client/requests/AddPartnerTagsRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partners/client/requests/CreatePartnerRequest.d.ts

@@ -3,6 +3,7 @@
  *     {
  *         email: "sam@example.com",
  *         program_id: "prg_T6z8aRW3XCmvFWP972RKxpAd",
+ *         external_id: "user_123",
  *         first_name: "Sam",
  *         last_name: "Taylor",
  *         group_id: "grp_zUQ8Pt281MsbNDApmDPN3Y2a",
@@ -17,6 +18,8 @@ export interface CreatePartnerRequest {
     email: string;
     /** Id of the program to add the partner to (prg_...), as returned when listing programs. */
     program_id: string;
+    /** Your own id for this partner, such as the user id in your app, so you can find them by it later. No other partner in the program can have it. */
+    external_id?: string;
     /** Partner's first name. With last_name it is used for the default link value when link is omitted. */
     first_name?: string;
     /** Partner's last name. With first_name it makes up the name shown for the partner unless display_name is set. */

package/dist/api/resources/partners/client/requests/ListPartnersRequest.d.ts

@@ -28,6 +28,10 @@ export interface ListPartnersRequest {
     program_id?: string;
     /** Limit to partners in one group, by the group id (grp_...) as returned when listing groups. */
     group_id?: string;
+    /** Limit to partners with this tag, by the tag id (ptag_...) as returned when listing partner tags. */
+    tag_id?: string;
+    /** Keep only partners with this external_id, matched exactly. Add program_id to get at most one partner. */
+    external_id?: string;
     /** Text matched anywhere in the partner's id, email, first name, last name or company name, ignoring case. */
     search?: string;
 }

package/dist/api/resources/partners/client/requests/RemovePartnerTagRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @example
+ *     {
+ *         id: "part_NLYzgNKuSuASvrvoxNtau6SY",
+ *         tag_id: "ptag_zDEcdqNuNBPcokarWxBnk9gB"
+ *     }
+ */
+export interface RemovePartnerTagRequest {
+    id: string;
+    tag_id: string;
+}

package/dist/api/resources/partners/client/requests/RemovePartnerTagRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partners/client/requests/UpdatePartnerRequest.d.ts

@@ -19,6 +19,8 @@ export interface UpdatePartnerRequest {
     country_code?: string | null;
     /** URL of the partner's website, starting with http:// or https://; null clears it. */
     website_url?: string | null;
+    /** Your own id for this partner, such as the user id in your app. No other partner in the program can have it; null clears it. */
+    external_id?: string | null;
     /** Id of a group in the partner's program to move them to (grp_...), as returned when listing groups. Commission flows scoped to that group then apply to them; null removes them from their group. */
     group_id?: string | null;
 }

package/dist/api/resources/partners/client/requests/index.d.ts

@@ -1,3 +1,4 @@
+export type { AddPartnerTagsRequest } from "./AddPartnerTagsRequest.js";
 export type { ApprovePartnerRequest } from "./ApprovePartnerRequest.js";
 export type { BulkApprovePartnersRequest } from "./BulkApprovePartnersRequest.js";
 export type { BulkRejectPartnersRequest } from "./BulkRejectPartnersRequest.js";
@@ -5,5 +6,6 @@ export { CreatePartnerRequest } from "./CreatePartnerRequest.js";
 export type { GetPartnerRequest } from "./GetPartnerRequest.js";
 export type { ListPartnersRequest } from "./ListPartnersRequest.js";
 export type { RejectPartnerRequest } from "./RejectPartnerRequest.js";
+export type { RemovePartnerTagRequest } from "./RemovePartnerTagRequest.js";
 export type { SuspendPartnerRequest } from "./SuspendPartnerRequest.js";
 export type { UpdatePartnerRequest } from "./UpdatePartnerRequest.js";

package/dist/api/resources/partners/types/AddPartnerTagsResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as ToltApi from "../../../index.js";
+export interface AddPartnerTagsResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTagSummary[];
+}

package/dist/api/resources/partners/types/AddPartnerTagsResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partners/types/RemovePartnerTagResponse.d.ts

@@ -0,0 +1,6 @@
+import type * as ToltApi from "../../../index.js";
+export interface RemovePartnerTagResponse {
+    success: boolean;
+    message: string;
+    data: ToltApi.PartnerTagSummary[];
+}

package/dist/api/resources/partners/types/RemovePartnerTagResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/resources/partners/types/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./AddPartnerTagsResponse.js";
 export * from "./ApprovePartnerResponse.js";
 export * from "./BulkApprovePartnersResponse.js";
 export * from "./BulkRejectPartnersResponse.js";
@@ -8,5 +9,6 @@ export * from "./ListPartnersRequestSort.js";
 export * from "./ListPartnersRequestStatus.js";
 export * from "./ListPartnersResponse.js";
 export * from "./RejectPartnerResponse.js";
+export * from "./RemovePartnerTagResponse.js";
 export * from "./SuspendPartnerResponse.js";
 export * from "./UpdatePartnerResponse.js";

package/dist/api/resources/partners/types/index.js

@@ -1,3 +1,4 @@
+export * from "./AddPartnerTagsResponse.js";
 export * from "./ApprovePartnerResponse.js";
 export * from "./BulkApprovePartnersResponse.js";
 export * from "./BulkRejectPartnersResponse.js";
@@ -8,5 +9,6 @@ export * from "./ListPartnersRequestSort.js";
 export * from "./ListPartnersRequestStatus.js";
 export * from "./ListPartnersResponse.js";
 export * from "./RejectPartnerResponse.js";
+export * from "./RemovePartnerTagResponse.js";
 export * from "./SuspendPartnerResponse.js";
 export * from "./UpdatePartnerResponse.js";

package/dist/api/types/CreatedPartner.d.ts

@@ -2,6 +2,8 @@ import type * as ToltApi from "../index.js";
 export interface CreatedPartner {
     id: string;
     email: string;
+    /** Your own id for the partner, such as the user id in your app, or null. */
+    external_id: string | null;
     first_name: string | null;
     last_name: string | null;
     company_name: string | null;

package/dist/api/types/Partner.d.ts

@@ -1,6 +1,8 @@
 export interface Partner {
     id: string;
     email: string;
+    /** Your own id for the partner, such as the user id in your app, or null. */
+    external_id: string | null;
     first_name: string | null;
     last_name: string | null;
     company_name: string | null;