import type { PaginationQueryParams, Tag, TagMutable } from "../interfaces.js";
import type { HttpClient } from "../http/HttpClient.js";
import { RequestOptions } from "./utils.js";
/**
 * Resource dedicated to managing tags.
 */
export declare class TagsResource {
    private readonly http;
    constructor(http: HttpClient);
    /**
     * List tags configured for the company.
     *
     * @param query Optional pagination controls (`page`, `per_page`).
     * @param options Optional request overrides such as alternate auth token or abort signal.
     * @returns Array of {@link Tag} records.
     * @throws {APIError} When the API responds with an error status.
     */
    list(query?: PaginationQueryParams, options?: RequestOptions): Promise<Tag[]>;
    /**
     * Create a new tag.
     *
     * @param payload Mutable tag attributes taken directly from the spec.
     * @param options Optional request overrides such as alternate auth token or abort signal.
     * @returns The created {@link Tag}.
     * @throws {APIError} When the API responds with an error status.
     */
    create(payload: TagMutable, options?: RequestOptions): Promise<Tag>;
    /**
     * Retrieve a tag by identifier.
     *
     * @param tagId Identifier of the tag to fetch.
     * @param options Optional request overrides such as alternate auth token or abort signal.
     * @returns The requested {@link Tag}.
     * @throws {APIError} When the API responds with an error status.
     */
    retrieve(tagId: string, options?: RequestOptions): Promise<Tag>;
    /**
     * Update an existing tag.
     *
     * @param tagId Identifier of the tag to update.
     * @param payload Mutable tag attributes taken directly from the spec.
     * @param options Optional request overrides such as alternate auth token or abort signal.
     * @returns The updated {@link Tag}.
     * @throws {APIError} When the API responds with an error status.
     */
    update(tagId: string, payload: TagMutable, options?: RequestOptions): Promise<Tag>;
    /**
     * Delete a tag.
     *
     * @param tagId Identifier of the tag to delete.
     * @param options Optional request overrides such as alternate auth token or abort signal.
     * @returns Resolves to void when deletion succeeds.
     * @throws {APIError} When the API responds with an error status.
     */
    delete(tagId: string, options?: RequestOptions): Promise<void>;
}
//# sourceMappingURL=Tags.d.ts.map