@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Forms
@base https://api.hubapi.com
@version v3
@auth OAuth2 | ApiKey private-app in header
@endpoints 6
@toc marketing(6)

@endpoint GET /marketing/v3/forms
@optional {after: str, archived: bool, formTypes: [str], limit: int(int32)}
@returns(200) {paging: map{next: map{after: str, link: str}}, results: [any]}

@endpoint POST /marketing/v3/forms
@returns(201)

@endpoint GET /marketing/v3/forms/{formId}
@required {formId: str}
@optional {archived: bool}
@returns(200)

@endpoint PUT /marketing/v3/forms/{formId}
@required {formId: str}
@returns(200)

@endpoint DELETE /marketing/v3/forms/{formId}
@required {formId: str}
@returns(204)

@endpoint PATCH /marketing/v3/forms/{formId}
@required {formId: str}
@optional {archived: bool, configuration: map{allowLinkToResetKnownValues!: bool, archivable!: bool, cloneable!: bool, createNewContactForNewEmail!: bool, editable!: bool, embedType: str, language!: str, lifecycleStages!: [map], notifyContactOwner!: bool, notifyRecipients!: [str], postSubmitAction!: map, prePopulateKnownValues!: bool, recaptchaEnabled!: bool}, displayOptions: map{cssClass: str, renderRawHtml!: bool, style!: map, submitButtonText!: str, theme!: str}, fieldGroups: [map{fields!: [any], groupType!: str, richText: str, richTextType!: str}], legalConsentOptions: any, name: str}
@returns(200)

@end