Page MenuHomeMTRNord's Forge
Conduit badge.edit

badge.edit

API Method: badge.edit

Login Required: This method requires authentication. You must log in before you can make calls to it.
Summary
Apply transactions to create a new badge or edit an existing one.
Returns
map<string, wild>
Errors
  • ERR-CONDUIT-CORE: See error message for details.
OAuth Scope
OAuth clients may never call this method.

Method Description

This is a standard ApplicationEditor method which allows you to create and modify objects by applying transactions. For documentation on these endpoints, see Conduit API: Using Edit Endpoints.

Transaction Summary

This endpoint supports these types of transactions. See below for detailed information about each transaction type.

KeyDescription
nameBadge name.
flavorShort description of the badge.
iconChange the badge icon.
qualityColor and rarity of the badge.
descriptionBadge long description.
awardNew badge award recipients.
revokeRevoke badge award recipients.
editChange the edit policy of the object.
subscribers.addAdd subscribers.
subscribers.removeRemove subscribers.
subscribers.setSet subscribers, overwriting current value.
commentMake comments.
mfaSign this transaction group with MFA.

name

Badge name.

KeyTypeDescription
typeconstname
valuestringNew badge name.

flavor

Short description of the badge.

KeyTypeDescription
typeconstflavor
valuestringNew badge flavor.

icon

Change the badge icon.

KeyTypeDescription
typeconsticon
valuestringNew badge icon.

quality

Color and rarity of the badge.

KeyTypeDescription
typeconstquality
valuestringNew badge quality.

description

Badge long description.

KeyTypeDescription
typeconstdescription
valuestringNew badge description.

award

New badge award recipients.

KeyTypeDescription
typeconstaward
valuelist<phid>New badge award recipients.

revoke

Revoke badge award recipients.

KeyTypeDescription
typeconstrevoke
valuelist<phid>Revoke badge award recipients.

edit

Change the edit policy of the object.

KeyTypeDescription
typeconstedit
valuestringNew policy PHID or constant.

subscribers.add

Add subscribers.

KeyTypeDescription
typeconstsubscribers.add
valuelist<user>List of PHIDs to add.

subscribers.remove

Remove subscribers.

KeyTypeDescription
typeconstsubscribers.remove
valuelist<user>List of PHIDs to remove.

subscribers.set

Set subscribers, overwriting current value.

KeyTypeDescription
typeconstsubscribers.set
valuelist<user>List of PHIDs to set.

comment

Make comments.

KeyTypeDescription
typeconstcomment
valuestringComment to add, formatted as remarkup.

mfa

Sign this transaction group with MFA.

KeyTypeDescription
typeconstmfa
valueboolTrue to sign this transaction group with MFA.

Call Method

Enter parameters using JSON. For instance, to enter a list, type: ["apple", "banana", "cherry"]

list<map<string, wild>>
optional id|phid|string

Examples

  • Use the Conduit API Tokens panel in Settings to generate or manage API tokens.
  • If you submit parameters, these examples will update to show exactly how to encode the parameters you submit.
$ echo <json-parameters> | arc call-conduit --conduit-uri https://phorge.mtrnord.blog/ --conduit-token <conduit-token> -- badge.edit